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GroupWise 8 Troubleshooting 3: Message Flow and Directory Structure 


About This Guide 


This Novell GroupWise Troubleshooting 3 Guide provides diagrams to help you understand the 
structure and functioning of your GroupWise system. The guide is divided into the following 
sections: 

+ “Message Flow Diagrams” on page 11 


¢ “Directory Structure Diagrams” on page 55 
Other sources of troubleshooting assistance include: 
+ Novell Support and Knowledgebase (http://www.novell.com/support) 


To search the GroupWise documentation from the Novell Support Web site, click Advanced 
Search, select Documentation in the Search In drop-down list, select GroupWise in the Products 
drop-down list, type the search string, then click Search. 


+ GroupWise Support Forums (http://forums.novell.com/forumdisplay.php?érf=356) 
+ GroupWise Support Community (http://www.novell.com/support/products/groupwise) 


+ GroupWise Cool Solutions (http://www.novell.com/communities/coolsolutions/gwmag) 


Audience 


This guide is intended for network administrators who install and administer GroupWise. 


Feedback 


We want to hear your comments and suggestions about this manual and the other documentation 
included with this product. Please use the User Comments feature at the bottom of each page of the 
online documentation, or go to Novell Documentation Feedback (http://www.novell.com/ 
documentation/feedback.html) and enter your comments there. 


Additional Documentation 


For additional GroupWise documentation, see the following guides at the GroupWise 8 
Documentation Web site (http://www.novell.com/documentation/gw§8): 

¢ Installation Guide 

¢ Administration Guide 

+ Multi-System Administration Guide 

+ Interoperability Guide 

+ Troubleshooting 1: Error Messages 

+ Troubleshooting 2: Solutions to Common Problems 

+ GroupWise Client User Guides 

+ GroupWise Client Frequently Asked Questions (FAQ) 


About This Guide 
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Message Flow Diagrams 


This part of Troubleshooting 3: Message Flow and Directory Structure helps you understand how 
messages travel between GroupWise users and how administrative updates to GroupWise databases 
occur. 

+ Chapter 1, “Message Delivery in the Local Post Office,” on page 13 

+ Chapter 2, “Message Delivery to a Different Post Office,” on page 19 

+ Chapter 3, “Message Delivery to a Different Domain,” on page 25 

+ Chapter 4, “Message Delivery to and from the Internet,” on page 33 

+ Chapter 5, “Message Delivery through a Modem Connection,” on page 47 

+ Chapter 6, “Administrative Database Update,” on page 53 


Message Flow Diagrams 11 
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1,1 


Message Delivery in the Local Post 
Office 


The GroupWise 8 client always uses client/server access to the post office but it can interact with the 
POA for the post office in different ways. For a review, see “Changing GroupWise Modes” in 
“Getting Organized” in the GroupWise 8 Windows Client User Guide. 

+ Section 1.1, “Online Mode,” on page 13 

+ Section 1.2, “Caching Mode,” on page 14 

+ Section 1.3, “Remote Mode,” on page 17 


Online Mode 


This message flow diagram illustrates how a GroupWise message travels from one user to another in 
the local post office when the client and POA communicate by way of TCP/IP and the users are 
accessing their Online mailboxes. 


Figure 1-1 Message Flow in Online Mode 






wpcsin 

L 0.7 
ofmsg 

Le msgnnn.db 
ofuser 

L userxxx.db 
offiles 

L fdo-7f 
wpcsout 


Message Delivery in the Local Post Office 13 


14 


1.2 


Table 1-1 Message Flow in Online Mode Stages 


Stage 


O Sender 


© Sender's 
GroupWise Client 


© POA for Local 
Post Office 


© POA for Local 
Post Office 


© Recipient's 
GroupWise Client 


O Recipient 
@ Recipient's 
GroupWise Client 


© POA for Local 
Post Office 
© POA for Local 
Post Office 


D Sender 


Icon 


E 


© 
5% 


POA 


N bg: 


Bo EN 


Caching Mode 


This message flow diagram illustrates how a GroupWise message travels from one user to another in 


Description 


The user sends a message to recipients in the same post office. The 
access mode setting for the post office is Client/Server Only. 


The GroupWise client communicates with the POA by way of TCP/IP. 


The POA receives the message from the GroupWise client and performs 
the following actions for the sender: 


+ Adds the message to the message database (msgnnn. db) 
assigned to the sender. 


+ Creates a pointer in the sender's user database (userxxx. db) so 
the message appears in the sender’s mailbox as a sent item. 


+ Places attachments larger than 2 KB in one of the 
post_office\offiles\fd0-F6 subdirectories and creates 
pointers from the message to its attachments. (For database 
efficiency, messages and distribution lists larger than 2 KB are also 
handled as attachments.) 


The POA also performs the following actions for the recipient: 


+ Creates a pointer in each recipient's user database (userxxx. db) 
to the message in the message database (msgnnn. db) so the new 
message appears in the recipient's mailbox. 


+ Updates the message in the message database (msgnnn. db) with 
a Delivered status for each recipient. 


The POA communicates to the GroupWise client by way of TCP/IP that a 
new message has arrived. 


The Notify component of the recipient's GroupWise client notifies the 
recipient that a new message has arrived. 


Each recipient opens the message in the GroupWise client. 


Each recipient's GroupWise client communicates the Opened status to 
the POA by way of TCP/IP. 


The POA receives the Opened status from the GroupWise client and 
updates the message in the message database with the Opened status 
for each recipient who opens the message. 


The POA communicate the Opened status to the sender's GroupWise 
client by way of TCP/IP. 


When the sender checks the sent items in his or her mailbox in the 
GroupWise client, the message displays a status of Delivered for each 
recipient (and possibly Opened as well if the recipient has opened the 
message). 


the local post office when the users are accessing their Caching mailboxes. 
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Figure 1-2 Message Flow in Caching Mode 
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Table 1-2 Message Flow in Caching Mode Stages 


Stage 


O Sender 


© Sender's 
GroupWise Client 


© Sender's 
GroupWise Client 


Icon 


A 
3 


Description 


The user sends a message to recipients in the same post office. The 
user is in Caching mode. 


The GroupWise client updates the sender's Caching mailbox 
(\novell\groupwise\gwxxxxxxx\rofdata) by performing the 
following actions: 


+ Adds the message to the message database (rofdata\msg. db) 
in the Caching mailbox. This database is local equivalent of the 
msgnnn. db database in the post office. 


+ Creates a pointer in the sender's user database 
(rofdata\user .db) in the Caching mailbox so the message 
appears in the sender's mailbox as a sent item. This database is 
the local equivalent of the userxxx. db database in the post office. 


+ Places attachments larger than 2 KB in the rofdata subdirectory 
in the Caching mailbox and creates pointers from the message to 
its attachments. (For database efficiency, messages and 
distribution lists larger than 2 KB are also handled as attachments.) 
There is no local equivalent to the offiles subdirectory in the 
post office, so attachments are placed directly in the rofdata 
subdirectory in the Caching mailbox. 


¢ Places a copy of the message in the rofdata\wpcsin\1 priority 
subdirectory to await the next connection to the POA. 


In Caching mode, sending a message always initiates an immediate 
connection with the POA in order to send the message. The GroupWise 
client communicates the message to the POA and deletes the copy in 
the rofdata\wpcsin\1 priority subdirectory when the POA has 
processed the message. 
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Icon 


Description 


Stage 


The POA receives the message from the GroupWise client and performs 


© POA for Local 
Post Office 


© POA for Local 
Post Office 


O POA for Local 
Post Office 


@ Recipient's 
GroupWise Client 


© Recipient's 
GroupWise Client 


© Recipient 


O Recipient's 
GroupWise Client 


5% 


POA 


Gk Q 


the following actions for the sender to update the sender’s Online 
mailbox: 


+ Adds the message to the message database (msgnnn. db) 
assigned to the sender in the post office. 


+ Creates a pointer in the sender's user database (userxxx. db) in 
the post office. 


+ Places attachments larger than 2 KB in one of the 
post_office\offiles\fd0-Fé subdirectories in the post office 
and creates pointers from the message to its attachments. (For 
database efficiency, messages and distribution lists larger than 2 
KB are also handled as attachments.) 


The POA also performs the following actions for the recipients to update 
their Online mailboxes: 


+ Creates a pointer in each recipient's user database (userxxx. db) 
to the message in the message database (msgnnn. db) in the post 
office so that the new message appears in each recipient's mailbox. 


+ Updates the message in the message database (msgnnn. db) in 
the post office with a Delivered status for the recipients. 


Because the recipients are also in Caching mode, they do not receive 
immediate notification that a new message has arrived in their Online 
mailboxes. Based on the Send/Retrieve All Marked Accounts Every nn 
Minutes option under Accounts > Account Options > General, each 
recipient’s GroupWise client sends a request to the POA for items that 
have arrived in the recipient’s Online mailbox since the last connection 
with the POA. 


The POA responds by sending information to update each recipient's 
Caching mailbox and communicates to the GroupWise client that a new 
message has arrived. 


Each recipient's GroupWise client updates the recipient's Caching 
mailbox by performing the following actions: 


+ Adds the message to the message database (rofdata\msg. db) 
in the recipient’s Caching mailbox. 


+ Creates a pointer in the recipient's user database 
(rofdata\user . db) to the message in the message database 
(rofdata\msg.db) so the new message appears in the recipient's 
Caching mailbox. 


The Notify component of each recipient’s GroupWise client notifies the 
recipient that a new message has arrived. 


Each recipient opens the message in the GroupWise client. 


Each recipient's GroupWise client generates an Opened status and 
places it in the rofdata\wpcsin\1 priority subdirectory to await the 


next connection with the POA. 
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1.3 


Stage 


® Recipient's 
GroupWise Client 


®© POA for Local 


Post Office 


® Recipient's 


GroupWise Client 


@ POA for Local 


Post Office 


® Recipient's 
GroupWise Client 


© Sender 


Icon 


E 


Remote Mode 


Before you can use Remote mode, you must create a Remote mailbox on your computer and have a 
connection to your master GroupWise system. See Chapter 5, “Message Delivery through a Modem 
Connection,” on page 47. 


Description 


When each recipient sends a message or the time specified by the Sena/ 
Receive All Marked Accounts Every nn Minutes option has elapsed, 
each recipient's GroupWise client connects with the POA and 
communicates the Opened status to the POA, along with any other data 
that needs to be uploaded to the recipient's Online mailbox. 


The POA receives the Opened status from the GroupWise client and 
updates the message in the sender's message database with the 
Opened status. 


Because the sender is in Caching mode, the sender does not 
immediately receive the Opened status. Based on the sender's actions 
and caching schedule, the sender's GroupWise client eventually sends a 
request to the POA for items that have arrived in the sender's Online 
mailbox since the last synchronization of the Caching mailbox. 


The POA responds by sending information to update the sender's 
Caching mailbox and communicates the Opened status to the sender's 
GroupWise client. 


The sender's GroupWise client updates the sender's Caching mailbox by 
performing the following action: 


+ Updates the message in the message database 
(rofdatalmsg. db) with a Delivered and Opened status for each 
recipient. 


When the sender checks the sent items in his or her mailbox in the 
GroupWise client, the message displays a status of Delivered and 
Opened for each recipient. 
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2.1 


Message Delivery to a Different Post 
Office 


The MTA handles message transfer between post offices. 


+ Section 2.1, “TCP/IP Link Open: Transfer between Post Offices Successful,” on page 19 

+ Section 2.2, “TCP/IP Link Closed: Transfer between Post Offices Delayed,” on page 22 
The message flow diagrams in GroupWise 8 Troubleshooting 3: Message Flow and Directory Structure 
focus on TCP/IP links because they are the most common and convenient (unless you have a post 
office and a domain on the same server). For diagrams that include mapped/UNC links, see 
GroupWise 6.5 Troubleshooting 3: Message Flow and Directory Structure (http://www.novell.com/ 
documentation/gw65/gw65_tsh3/data/a4ehibh.html). For an explanation of link types and link 


protocols, see “Understanding Link Configuration” in “Domains” in the GroupWise 8 Administration 
Guide. 


TCP/IP Link Open: Transfer between Post Offices 
Successful 


This message flow diagram illustrates how a GroupWise message travels from one user to another 
between post offices in the same domain when the TCP/IP link between the post office and the 
domain is open. 


Figure 2-1 Message Flow When the TCP/IP Link is Open 
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Table 2-1 Message Flow When the TCP/IP Link is Open Stages 


Stage 


O Sender 


© Sender's 
GroupWise 
Client 


© POA for 
Sender’s Post 
Office 


O POA for 
Sender's Post 
Office 


© MIA for 
Local Domain 


@ MIA for 
Local Domain 


Icon 


& 


3 
5% 


Description 


The user sends a message to recipients in a different post office in the same 
domain. 


In this diagram, the access mode setting in the local post office is Client/Server 
Only. 


The GroupWise client communicates the message to the POA by way of TCP/ 
IP. 


The POA receives the message from the GroupWise client and performs the 
following actions for the sender: 


+ Adds the message to the message database (msgnnn. db) assigned to 
the sender. 


+ Creates a pointer in the sender's user database (userxxx. db) so the 
message appears in the sender's mailbox as a sent item. 


+ Places attachments larger than 2 KB in one of the 
post_office\offiles\fd0-F6 subdirectories and creates pointers 
from the message to its attachments. (For database efficiency, messages 
and distribution lists larger than 2 KB are also handled as attachments.) 


+ Creates a copy of the message in the appropriate priority 0-7 
subdirectory of the MTA input queue in the sender's post office, in case 
the TCP/IP link to the MTA is currently closed. 


The POA then communicates the message to the MTA by way of TCP/IP, and 
deletes the copy in the MTA input queue because the TCP/IP transfer to the 
MTA was successful. 


To see what happens if the TCP/IP link to the MTA is closed, see Section 2.2, 
“TCP/IP Link Closed: Transfer between Post Offices Delayed,” on page 22. 


The MTA receives the message and places it into the MTA “in progress” 
(gwinprog) queue. 


The MTA then communicates the message to the POA in the recipient’s post 
office by way of TCP/IP. When the transmission is successful, the MTA deletes 
the message from the MTA “in progress” queue. 


If the TCP/IP link to the recipient’s post office is closed, the message is placed 
in the closed post office’s holding queue in the MTA’s mslocal directory for 
later transfer. The resulting message flow is parallel to what occurs when a 
domain is closed. See Section 3.2, “TCP/IP Link Closed: Transfer between 
Domains Delayed,” on page 28 for a similar message flow that illustrates how 
messages to closed locations are handled. 
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Stage 


@ POA for 
Recipient’s 
Post Office 


© POA for 
Local Post 
Office 


© Recipient's 
GroupWise 
Client 


OD Recipient 


® Recipient's 
GroupWise 
Client 


® POA for 
Recipient’s 
Post Office 


® MITA for 
Local Domain 


@ MIA for 
Local Domain 


® POA in 
Sender’s Post 
Office 


®© POA for 
Local Post 
Office 


@ Sender 


Icon 


POA 


Description 


When the POA receives the new message from the MTA, it places it into the 
MTA output queue in the post office (wocsout \ofs\ 0-7) on behalf of the 
MTA. Then, the POA for the recipient's post office performs the following 
actions: 


+ Adds the message to the message database (msgnnn. db) 
corresponding to the one assigned to the sender. 


+ Creates a pointer in the recipient’s user database (userxxx.db) so the 
new message appears in the recipient’s mailbox and updates the 
notification information in the user database so the recipient can be 
notified of the message. 


+ Places attachments larger than 2 KB in one of the 
post_office\offiles\fd0-F6 subdirectories and creates pointers 
from the message to its attachments. (For database efficiency, messages 
and distribution lists larger than 2 KB are also handled as attachments.) 


+ Creates a Delivered status message in the appropriate priority 0-7 
subdirectory of the MTA input queue in the recipient's post office. It also 
communicates the Delivered status message directly to the MTA by way 
of TCP/IP. When that transmission is successful, the copy in the MTA 
input queue is deleted. 


The POA communicates to the GroupWise client by way of TCP/IP that a new 
message has arrived. 


The Notify component of the recipient's GroupWise client notifies the recipient 
that a new message has arrived. 


Each recipient opens the message in the GroupWise client. 


Each recipient's GroupWise client communicates the Opened status message 
to the POA by way of TCP/IP. 


The POA for the recipient's post office communicates the status message to 
the MTA by way of TCP/IP. 


The MTA places the status message into the MTA “in progress” (gwinprog) 
queue. 


The MTA communicates the status message to the POA for the sender’s post 
office by way of TCP/IP. 


The POA for the sender’s post office updates the sender’s message database 
(msgnnn. db) with the Delivered status information (and possibly Opened as 
well if the recipient has opened the message). 


The POA communicates the status to the sender’s GroupWise client by way of 
TCP/IP. 


When the sender checks the sent items in his or her mailbox in the GroupWise 
client, the message displays a status of Delivered for each recipient (and 
possibly Opened as well if the recipient has opened the message). 
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2.2 TCP/IP Link Closed: Transfer between Post Offices Delayed 


This message flow diagram illustrates how a GroupWise message travels from one user to another 
between post offices in the same domain when the TCP/IP link between the post office and the 
domain is closed. 


Figure 2-2 Message Flow When the TCP/IP Link is Closed 
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Table 2-2 Message Flow When the TCP/IP Link is Closed Stages 


Stage Icon Description 
O Sender aa The user sends a message to recipients in a different post office in the same 
domain. 


In this diagram, the access mode setting in the local post office is Client/Server 


Only. 
O Sender's ® The GroupWise client communicates the message to the POA by way of TCP/ 
GroupWise IP. 
Client 
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Stage 


© POA for 
Sender’s Post 
Office 


© POA for 
Sender’s Post 
Office 


© MTA for 
Local Domain 


O MIA for 
Local Domain 


@ POA for 
Recipient’s 
Post Office 


Icon 


5% 


POA 


Description 


The POA receives the message from the GroupWise client and performs the 
following actions for the sender: 


+ Adds the message to the message database (msgnnn. db) assigned to 
the sender. 


+ Creates a pointer in the sender's user database (userxxx. db) so the 
message appears in the sender's mailbox as a sent item. 


+ Places attachments larger than 2 KB in one of the 
post_office\offiles\fd0-F6 subdirectories and creates pointers 
from the message to its attachments. (For database efficiency, messages 
and distribution lists larger than 2 KB are also handled as attachments.) 


+ Creates a copy of the message in the appropriate priority 0-7 
subdirectory of the MTA input queue in the sender's post office, in case 
the TCP/IP link to the MTA is currently closed. 


The POA then attempts to communicate the message to the MTA by way of 
TCP/IP, but the MTA does not respond. The POA leaves the copy of the 
message in the MTA input queue and periodically attempts to contact the MTA. 
When the MTA responds again, the POA communicates the message and 
deletes the copy in the MTA input queue after the TCP/IP transmission to the 
MTA is successful. 


The MTA receives the message and places it into the MTA “in progress” 
(gwinprog) queue. 


The MTA then communicates the message to the POA in the recipient’s post 
office by way of TCP/IP. When the transmission is successful, the MTA deletes 
the message from the MTA “in progress” (gwinprog) queue. 


If the TCP/IP link to the recipient's post office is closed, the message is placed 
in the closed post office’s holding queue in the MTA’s mslocal directory for 
later transfer. The resulting message flow is parallel to what occurs when a 
domain is closed. For a similar message flow that illustrates how messages to 
closed locations are handled, see Section 3.2, “TCP/IP Link Closed: Transfer 
between Domains Delayed,” on page 28. 


When it receives the new message, the POA for the recipient's post office 
performs the following actions: 


+ Adds the message to the message database (msgnnn. db) 
corresponding to the one assigned to the sender. 


+ Creates a pointer in the recipient’s user database (userxxx.db) so the 
new message appears in the recipient's mailbox and updates the 
notification information in the user database so the recipient can be 
notified of the message. 


+ Places attachments larger than 2 KB in one of the 
post_office\offiles\fd0-F6 subdirectories and creates pointers 
from the message to its attachments. (For database efficiency, messages 
and distribution lists larger than 2 KB are also handled as attachments.) 


+ Creates a Delivered status message in the appropriate priority 0-7 
subdirectory of the MTA input queue in the recipient's post office. It also 
communicates the Delivered status message directly to the MTA by way 
of TCP/IP and when that transmission is successful, the copy in the MTA 
input queue is deleted. 
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24 


Stage 


© POA for 
Local Post 
Office 


© Recipients 
GroupWise 
Client 


OD Recipient 


® Recipient's 
GroupWise 
Client 


®© POA for 
Recipient’s 
Post Office 


® MTA for 
Local Domain 


@ MTA for 
Local Domain 


® POA in 
Sender’s Post 
Office 


D POA for 
Local Post 
Office 


@ Sender 


Icon 


Description 


The POA communicates to the GroupWise client by way of TCP/IP that a new 
message has arrived. 


The Notify component of the recipient's GroupWise client notifies the recipient 
that a new message has arrived. 


Each recipient opens the message in the GroupWise client. 


Each recipient's GroupWise client communicates the Opened status message 
to the POA by way of TCP/IP. 


The POA for the recipient’s post office communicates the status message to 
the MTA by way of TCP/IP. 


The MTA places the status message into the MTA “in progress” (gwinprog) 
queue. 


The MTA communicates the status message to the POA for the sender’s post 
office by way of TCP/IP. 


The POA for the sender’s post office updates the sender’s message database 
(msgnnn. db) with the Delivered status information (and possibly Opened as 
well if the recipient has opened the message). 


The POA communicates the Opened status to the sender’s GroupWise client 
by way of TCP/IP. 


When the sender checks the sent items in his or her mailbox in the GroupWise 
client, the message displays a status of Delivered for each recipient (and 
possibly Opened as well if the recipient has opened the message). 
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3.1 


Message Delivery to a Different Domain 


The MTA handles message transfer between domains. 


¢ Section 3.1, “TCP/IP Link Open: Transfer between Domains Successful,” on page 25 

+ Section 3.2, “TCP/IP Link Closed: Transfer between Domains Delayed,” on page 28 
The message flow diagrams in GroupWise 8 Troubleshooting 3: Message Flow and Directory Structure 
focus on TCP/IP links because they are the most common and convenient (unless you have two 
domains on the same server). For diagrams that include mapped/UNC links, see GroupWise 6.5 
Troubleshooting 3: Message Flow and Directory Structure (http://www.novell.com/documentation/gw65/ 


gw65_tsh3/data/a4ehibh.html). For an explanation of link types and link protocols, see 
“Understanding Link Configuration” in “Domains” in the GroupWise 8 Administration Guide. 


TCP/IP Link Open: Transfer between Domains Successful 


This message flow diagram illustrates how a GroupWise message travels from one user to another 
when the domains are connected by a TCP/IP link and the link is open. 


Figure 3-1 Message Flow When the TCP/IP Link is Open 
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Table 3-1 Message Flow When the TCP/IP Link is Open Stages 


Stage 


O Sender 


© Sender's 
GroupWise 
Client 


© POA for 
Sender's 
Post Office 


© POA for 
Sender's 
Post Office 


© MIA for 
Sender's 
Domain 


@ MTA for 
Sender's 
Domain 


@ MTA for 
Recipient's 
Domain 


© MTA for 
Recipient’s 
Domain 


Icon 


Ea 


© 
5% 


POA 


Description 


The user sends a message to recipients in a post office in a different domain. 


In this diagram, the access mode setting for the local post office is Client/Server 
Only. 


The GroupWise client communicates the message to the POA by way of TCP/IP. 


The POA receives the message from the GroupWise client and performs the 
following actions for the sender: 


+ Adds the message to the message database (msgnnn. db) assigned to the 
sender. 


+ Creates a pointer in the sender's user database (userxxx. db) so the 
message appears in the sender's mailbox as a sent item. 


+ Places attachments larger than 2 KB in one of the 
post_officeloffileslfd0-F6 subdirectories and creates pointers 
from the message to its attachments. (For database efficiency, messages 
and distribution lists larger than 2 KB are also handled as attachments.) 


+ Creates a copy of the message in the appropriate priority 0-7 subdirectory 
of the MTA input queue in the sender’s post office, in case the TCP/IP link to 
the MTA is currently closed. 


The POA then communicates the message to the MTA for the sender’s domain 
by way of TCP/IP, and deletes the copy in the MTA input queue because the 
TCP/IP transfer to the MTA was successful. 


To see what would happen if the TCP/IP link to the MTA is closed, see 
Section 2.2, “TCP/IP Link Closed: Transfer between Post Offices Delayed,” on 
page 22. 


The MTA for the sender’s domain receives the message and places it into the 
MTA “in progress” (gwinprog) queue. 


The MTA for the sender’s domain then communicates the message to the MTA 
for the recipient's domain by way of TCP/IP. 


If the TCP/IP link to the recipient’s domain is closed, the message is placed in the 
closed domain’s holding queue in the MTA’s mslocal directory for later transfer. 
See Section 3.2, “TCP/IP Link Closed: Transfer between Domains Delayed,” on 
page 28. 


The MTA for the recipient’s domain receives the message and places it into the 
MTA “in progress” (gwinprog) queue. 


The MTA for the recipient’s domain then communicates the message to the POA 
in the recipient's post office by way of TCP/IP. 
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Stage 


O POA for 
Recipient's 
Post Office 


© POA for 
Recipient's 
Post Office 


D 
Recipient's 
GroupWise 
Client 


® Recipient 


® 
Recipient’s 
GroupWise 
Client 


@ POA for 
Recipient’s 
Post Office 


® MTA for 
Recipient’s 
Domain 


© MTA for 
Recipient's 
Domain 


®© MTA for 
Sender's 
Domain 


® MTA for 
Sender's 
Domain 


Icon 


5% 


POA 


ENS 


Description 


When it receives the new message, the POA for the recipient's post office 
performs the following actions: 


+ Adds the message to the message database (msgnnn. db) corresponding 
to the one assigned to the sender. 


+ Creates a pointer in the recipient’s user database (userxxx.db) so the 
new message appears in the recipient’s mailbox and updates the 
notification information in the user database so the recipient can be notified 
of the message. 


+ Places attachments larger than 2 KB in one of the 
post_office\offiles\fd0-Fé subdirectories and creates pointers 
from the message to its attachments. (For database efficiency, messages 
and distribution lists larger than 2 KB are also handled as attachments.) 


+ Creates a Delivered status message in the appropriate priority 0-7 
subdirectory of the MTA input queue in the recipient's post office. It also 
communicates the Delivered status message directly to the MTA by way of 
TCP/IP and when that transmission is successful, the copy in the MTA input 
queue is deleted. 


The POA for the recipient’s post office communicates to the GroupWise client by 
way of TCP/IP that a new message has arrived. 


The Notify component of the recipient's GroupWise client notifies the recipient 
that a new message has arrived. 


Each recipient opens the message in the GroupWise client. 


Each recipient's GroupWise client communicates the Opened status message to 
the POA by way of TCP/IP. 


The POA for the recipient's post office communicates the status message to the 
MTA for the recipient's domain by way of TCP/IP. 


The MTA for the recipient's domain places the status message into the MTA “in 
progress” (gwinprog) queue. 


The MTA for the recipient’s domain communicates the status message to the 
MTA for the sender’s domain by way of TCP/IP. 


The MTA for the sender’s domain places the status message into the MTA “in 
progress” (gwinprog) queue. 


The MTA for the sender’s domain communicates the status message to the POA 
for the sender’s post office by way of TCP/IP. 
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Stage Icon Description 


© POA for 4 The POA for the sender's post office updates the sender's message database 
Sender’s POA (msgnnn. db) with the Delivered status information (and possibly Opened as well 
Post Office if the recipient has opened the message). 


E) POA for SO The POA for the sender's post office communicates the status to the sender's 
Sender's POA GroupWise client by way of TCP/IP. 
Post Office 


@ Sender aa When the sender checks the sent items in his or her mailbox in the GroupWise 
client, the message displays a status of Delivered for each recipient (and possibly 
Opened as well if the recipient has opened the message). 


3.2 TCP/IP Link Closed: Transfer between Domains Delayed 


This message flow diagram illustrates how a GroupWise message travels from one user to another 
when the domains are connected by a TCP/IP link and the link is closed. 


Figure 3-2 Message Flow When the TCP/IP Link is Closed 
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Table 3-2 Message Flow When the TCP/IP Link is Closed Stages 


Stage Icon Description 


O Sender aa The user sends a message to recipients in a post office in a different domain. 


In this diagram, the access mode setting for the local post office is Client/Server 
Only. 


© Sender's ® The GroupWise client communicates the message to the POA by way of TCP/IP. 
GroupWise 
Client 
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Stage 


© POA for 
Sender's 
Post Office 


© POA for 
Sender’s 
Post Office 


© MIA for 
Sender’s 
Domain 


O MIA for 
Sender's 
Domain 


@ MIA for 
Recipient's 
Domain 


© MTA for 
Recipient’s 
Domain 


Icon 


POA 


Description 


The POA receives the message from the GroupWise client and performs the 
following actions for the sender: 


+ Adds the message to the message database (msgnnn. db) assigned to the 
sender. 


+ Creates a pointer in the sender's user database (userxxx. db) so the 
message appears in the sender's mailbox as a sent item. 


+ Places attachments larger than 2 KB in one of the 
post_office\offiles\fd0-Fé subdirectories and creates pointers 
from the message to its attachments. (For database efficiency, messages 
and distribution lists larger than 2 KB are also handled as attachments.) 


+ Creates a copy of the message in the appropriate priority 0-7 subdirectory 
of the MTA input queue in the sender’s post office, in case the TCP/IP link to 
the MTA is currently closed. 


The POA then communicates the message to the MTA for the sender’s domain 
by way of TCP/IP, and deletes the copy in the MTA input queue because the 
TCP/IP transfer to the MTA was successful. 


To see what would happen if the TCP/IP link to the MTA is closed, see 
Section 2.2, “TCP/IP Link Closed: Transfer between Post Offices Delayed,” on 
page 22. 


The MTA for the sender’s domain receives the message and places it into the 
MTA “in progress” (gwinprog) queue. 


The MTA for the sender’s domain then attempts to communicate the message to 
the MTA for the recipient's domain by way of TCP/IP, but the recipient MTA does 
not respond. Therefore, the MTA stores the message in its holding queue for the 
recipient’s domain in the mshold directory. 


When the MTA in the recipient’s domain responds again, the MTA for the 
sender's domain transfers the delayed message from the domain holding queue 
to the MTA in the recipient's domain by way of TCP/IP. 


The MTA for the recipient’s domain receives the message and places it into the 
MTA “in progress” (gwinprog) queue. 


The MTA for the recipient’s domain then communicates the message to the POA 
in the recipient's post office by way of TCP/IP. 


Message Delivery to a Different Domain 


29 


Stage 


O POA for 
Recipient's 
Post Office 


© POA for 
Recipient's 
Post Office 


D 
Recipient's 
GroupWise 
Client 


® Recipient 


® 
Recipient’s 
GroupWise 
Client 


@ POA for 
Recipient’s 
Post Office 


® MTA for 
Recipient’s 
Domain 


© MTA for 
Recipient's 
Domain 


®© MTA for 
Sender's 
Domain 


® MTA for 
Sender's 
Domain 


Icon 


5% 


POA 


ENS 


Description 


When it receives the new message, the POA for the recipient's post office 
performs the following actions: 


+ Adds the message to the message database (msgnnn. db) corresponding 
to the one assigned to the sender. 


+ Creates a pointer in the recipient’s user database (userxxx.db) so the 
new message appears in the recipient’s mailbox and updates the 
notification information in the user database so the recipient can be notified 
of the message. 


+ Places attachments larger than 2 KB in one of the 
post_office\offiles\fd0-Fésubdirectories and creates pointers from 
the message to its attachments. (For database efficiency, messages and 
distribution lists larger than 2 KB are also handled as attachments.) 


+ Creates a Delivered status message in the appropriate priority 0-7 
subdirectory of the MTA input queue in the recipient's post office. It also 
communicates the Delivered status message directly to the MTA by way of 
TCP/IP and when that transmission is successful, the copy the MTA input 
queue is deleted. 


The POA for the recipient’s post office communicates to the GroupWise client by 
way of TCP/IP that a new message has arrived. 


The Notify component of the recipient's GroupWise client notifies the recipient 
that a new message has arrived. 

Each recipient opens the message in the GroupWise client. 

Each recipient's GroupWise client communicates the Opened status message to 


the POA by way of TCP/IP. 


The POA for the recipient's post office communicates the status message to the 
MTA for the recipient's domain by way of TCP/IP. 


The MTA for the recipient’s domain places the status message into the “in 
progress” (gwinprog) queue. 


The MTA for the recipient's domain communicates the status message to the 
MTA for the sender’s domain by way of TCP/IP. 


The MTA for the sender’s domain places the status message into the MTA “in 
progress” (gwinprog) queue. 


The MTA for the sender’s domain communicates the status message to the POA 
for the sender’s post office by way of TCP/IP. 
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Stage 


® POA for 
Sender's 
Post Office 


® POA for 
Sender's 
Post Office 


E) Sender 


Icon 


Description 


The POA for the sender's post office updates the sender's message database 
(msgnnn. db) with the Delivered status information (and possibly Opened as well 
if the recipient has opened the message). 


The POA for the sender's post office communicates the status to the sender's 
GroupWise client by way of TCP/IP. 


When the sender checks the sent items in his or her mailbox in the GroupWise 
client, the message displays a status of Delivered for each recipient (and possibly 
Opened as well if the recipient has opened the message). 
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4.1 


Message Delivery to and from the 
Internet 


+ Section 4.1, “TCP/IP Link: Outbound Transfer to the Internet Successful,” on page 33 


+ Section 4.2, “TCP/IP Link: Outbound Transfer to the Internet Delayed or Unsuccessful,” on 
page 35 


+ Section 4.3, “Mapped/UNC Link: Outbound Transfer to the Internet Successful,” on page 38 


+ Section 4.4, “Mapped/UNC Link: Outbound Transfer to the Internet Delayed or Unsuccessful,” 
on page 41 


+ Section 4.5, “TCP/IP Link: Inbound Transfer from the Internet Successful,” on page 43 
+ Section 4.6, “Mapped/UNC Link: Inbound Transfer from the Internet Successful,” on page 45 


TCP/IP Link: Outbound Transfer to the Internet Successful 


This message flow diagram shows how outbound messages travel through the GroupWise directory 
structure to the Internet when there is a TCP/IP link between the MTA and the Internet Agent and 
when the Internet Agent can communicate successfully with the Internet host to which the message 
is addressed. 


Figure 4-1 Message Flow When the TCP/IP Link is Open 
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Table 4-1 Message Flow When the TCP/IP Link is Open Stages 


Stage 


O Sender 


© Sender's 
GroupWise 
Client 


© POA for 
Sender's Post 
Office 


© POA for 
Sender’s Post 
Office 


© MTA for 
Sender's 
Domain 


O MIA for 
Sender's 
Domain 


@ MTA for 
Sender's 
Domain 


© Internet 
Agent for 
Sender's 
Domain 


Icon 


E 


POA 


$ 


Description 


The user sends a message to recipients across the Internet by providing their 
Internet addresses. 


In this diagram, the access mode setting for the local post office is Client/Server 
Only. 


The GroupWise client communicates the message to the POA by way of TCP/ 
IP. 


The POA receives the message from the GroupWise client and performs the 
following actions for the sender: 


+ Adds the message to the message database (msgnnn. db) assigned to the 
sender. 


+ Creates a pointer in the sender's user database (userxxx. db) so the 
message appears in the sender’s mailbox as a sent item. 


+ Places attachments larger than 2 KB in one of the 
post_office\offiles\fd0-F6 subdirectories and creates pointers 
from the message to its attachments. (For database efficiency, messages 
and distribution lists larger than 2 KB are also handled as attachments.) 


+ Creates a copy of the message in the appropriate priority 0-7 subdirectory 
of the MTA input queue in the sender's post office, in case the TCP/IP link 
to the MTA is currently closed. 


The POA then communicates the message to the MTA for the sender’s domain 
by way of TCP/IP, and deletes the copy in the MTA input queue because the 
TCP/IP transfer to the MTA was successful. 


The MTA for the sender’s domain receives the message and places it into the 
MTA “in progress” (gwinprog) queue. 


The MTA determines that the message must be sent out across the Internet. 
Because there is a TCP/IP link between the MTA and the Internet Agent, the 
MTA creates a copy of the message in the appropriate priority 0-7 subdirectory 
of the Internet Agent hold queue (mslocal\mshold\gatewayx\ 0-7), in case 
the TCP/IP link to the Internet Agent is currently closed. 


The MTA then communicates the message to the Internet Agent for the sender’s 
domain by way of TCP/IP, and deletes the copy in the Internet Agent holding 
queue because the TCP/IP transfer to the Internet Agent was successful. 


The Internet Agent receives the message and places it into the MTA output 
queue (wpcsout \gwid\ 0-7) on behalf of the MTA. The MTA output queue is 
the Internet Agent input queue. 
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4.2 


Stage 


@ Internet 
Agent for 
Sender's 
Domain 


O Internet 
Agent for 
Sender's 
Domain 


@® Internet 
Agent for 
Sender's 
Domain 


@ Internet 
Agent for 
Sender's 
Domain 


® MIA for 
Sender's 
Domain 


@ MTA for 
Sender's 
Domain 


® POA for 
Sender's Post 
Office 


D POA for 
Sender’s Post 
Office 


@ Sender 


Icon 


GWIA 


= 


5% 


POA 


POA 


E 


Description 


The Internet Agent scans its input queues according to the /dle Sleep Duration 
setting on the Gateway Time Settings page of the Internet Agent object in 
ConsoleOne. The Internet Agent picks up the file in binary-encrypted format 
from the wpcsout \gwid\ 0-7 directory and converts it. 


The Internet Agent encodes the message in MIME format with the appropriate 
encoding scheme. 


When the message file is built, the Internet Agent saves it with S as the first 
character of the filename and places the message file in the 
domain\wpgate\gwia\send directory for processing. 


While the Internet Agent is processing the message file in the send directory, it 
changes the first character of the filename to P. When processing is completed, 
the Internet Agent sends the message to the destination host across the 
Internet. 


If the Internet Agent receives a 250 OK SMTP reply code from the destination 
Internet host, it places a Transferred status message into the input queue of the 
MTA for the sender's domain in case the TCP/IP link to the Internet Agent is 
currently closed. 


The Internet Agent then communicates the Transferred status message to the 
MTA for the sender's domain by way of TCP/IP, and deletes the copy in the MTA 
input queue because the TCP/IP transfer to the MTA was successful. 


The MTA for the sender’s domain receives the Transferred status message and 
places it into the MTA “in progress” (gwinprog) queue for processing. 


The MTA for the sender’s domain communicates the Transferred status 
message to the POA for the sender’s post office by way of TCP/IP. 


The POA for the sender’s post office updates the sender's message database 
(msgnnn. db) with the Transferred status information. 


The POA for the sender’s post office communicates the Transferred status to the 
sender's GroupWise client by way of TCP/IP. 


When the sender checks the sent items in his or her mailbox in the GroupWise 
client, the message displays the Transferred status because the Internet Agent 
was able to sent it successfully. 


TCP/IP Link: Outbound Transfer to the Internet Delayed or 
Unsuccessful 


This message flow diagram shows how outbound messages travel through the GroupWise directory 
structure to the Internet when there is a TCP/IP link between the MTA and the Internet Agent and 
when the Internet Agent cannot communicate successfully with the Internet host to which the 
message is addressed. 


Message Delivery to and from the Internet 35 


36 


Figure 4-2 Message Flow When the TCP/IP Link is Closed 
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Table 4-2 Message Flow When the TCP/IP Link is Closed Stages 


Stage Icon 


O Sender a 


© Sender’s 
GroupWise S 
Client 

© POA for 


Sender's Post 
Office 


POA 


O POA for 
Sender's Post s4 
Office 


POA 


Description 


The user sends a message to recipients across the Internet by providing their 
Internet addresses. 


In this diagram, the access mode setting for the local post office is Client/Server 
Only. 


The GroupWise client communicates the message to the POA by way of TCP/ 
IP. 


The POA receives the message from the GroupWise client and performs the 
following actions for the sender: 


+ Adds the message to the message database (msgnnn. db) assigned to the 
sender. 


+ Creates a pointer in the sender's user database (userxxx. db) so the 
message appears in the sender's mailbox as a sent item. 


+ Places attachments larger than 2 KB in one of the 


post_office\offiles\fd0-F6 subdirectories and creates pointers 
from the message to its attachments. (For database efficiency, messages 
and distribution lists larger than 2 KB are also handled as attachments.) 


+ Creates a copy of the message in the appropriate priority 0-7 subdirectory 


of the MTA input queue in the sender's post office, in case the TCP/IP link 
to the MTA is currently closed. 


The POA then communicates the message to the MTA for the sender’s domain 


by way of TCP/IP, and deletes the copy in the MTA input queue because the 
TCP/IP transfer to the MTA was successful. 
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Stage 


© MIA for 
Sender's 
Domain 


O MTA for 
Sender's 
Domain 


@ MTA for 
Sender's 
Domain 


© Internet 
Agent for 
Sender's 
Domain 


O Internet 
Agent for 
Sender's 
Domain 


O Internet 
Agent for 
Sender's 
Domain 


O Internet 
Agent for 
Sender's 
Domain 


@ Internet 
Agent for 
Sender's 
Domain 


® Internet 
Agent for 
Sender's 
Domain 


MTA 


GWIA 


GWIA 


GWIA 


GWIA 


GWIA 


Description 


The MTA for the sender's domain receives the message and places it into the 
MTA “in progress” (gwinprog) queue. 


The MTA determines that the message must be sent out across the Internet. 
Because there is a TCP/IP link between the MTA and the Internet Agent, the 
MTA creates a copy of the message in the appropriate priority 0-7 subdirectory 
of the Internet Agent hold queue (mslocal\mshold\gatewayx\ 0-7), in case 
the TCP/IP link to the Internet Agent is currently closed. 


The MTA then communicates the message to the Internet Agent for the sender's 
domain by way of TCP/IP, and deletes the copy in the Internet Agent holding 
queue because the TCP/IP transfer to the Internet Agent was successful. 


The Internet Agent receives the message and places it into the MTA output 
queue (wpcsout \gwid\ 0-7) on behalf of the MTA. The MTA output queue is 
the Internet Agent input queue. 


The Internet Agent scans its input queues according to the /dle Sleep Duration 
setting on the Gateway Time Settings page of the Internet Agent object in 
ConsoleOne. The Internet Agent picks up the file in binary-encrypted format 
from the wpcsout \gwid\ 0-7 directory and converts it. 


The Internet Agent encodes the message in MIME format with the appropriate 
encoding scheme. 


When the message file is built, the Internet Agent saves it with S as the first 
character of the filename and places the message file in the 
domain\wpgate\gwia\send directory for processing. 


While the Internet Agent is processing the message file in the send directory, it 
changes the first character of the filename to P. When processing is completed, 
the Internet Agent sends the message to the destination host across the 
Internet. 


If the Internet Agent does not receive a 250 OK SMTP reply code from the 
destination Internet host, the Internet Agent renames the P* . * message file 
back to S* . * and creates a file named R* . * that records the SMTP reply codes 
(error messages) in the wpgate\gwia\result directory. After the Internet 
Agent completes the communication with the destination host, it moves the 

S* .* message file from the send directory to the result directory along with the 
corresponding R* . * file. 


The Internet Agent analyzes the files in the result directory, comparing the 
SMTP reply codes in the R* . * file. 


If the R*.* file has a temporary transmission error (meaning it has a 400-level 
SMTP reply code such as 450 Host Down), the Internet Agent moves the S* . * 
message file to the defer directory. Continue with Stage ® 


If the R* . * file has a fatal error (meaning it has a 500-level SMTP reply code 
such as 550 Host Unknown), the Internet Agent deletes the S* . * file because it 
is undeliverable. Skip to Stage @ 


Based on the /ntervals to the Retry a Deferred Message setting on the SMTP/ 
MIME Settings property page of the Internet Agent object in ConsoleOne, the 
Internet Agent requeues the S *.* message file back into the send directory for 
reprocessing. 
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Stage Icon 


@ Internet GWIA 


Agent for = 


Sender's 
Domain 


® Internet GWIA 


Agent for = 


Sender's 

Domain 

®© MTA for D 
Sender's HTA 
Domain 

© MTA for p 
Sender's HTA 
Domain 


D POA for SO 


Sender’s Post Poa 


Office 

® POA for 
Sender's Post 54 
Office 

E) Sender a 


Description 


After an S* . * message receives 400-level SMTP reply codes until the 
Maximum Number of Hours to Retry a Deferred Message setting is reached, or 
if a message receives 500-level SMTP reply codes, the Internet Agent deletes 
all related schedule files from the defer directory because the message is 
undeliverable. The Internet Agent then creates an Undeliverable status 
message in the MTA input queue (wpgate\gwia\wpcsin\ 0-7) in case the 
TCP/IP link to the MTA is currently closed. 


The Internet Agent then communicates the Transferred status message to the 
MTA for the sender’s domain by way of TCP/IP, and deletes the copy in the MTA 
input queue because the TCP/IP transfer to the MTA was successful. 


The MTA for the sender’s domain receives the Transferred status message and 
places it into the MTA “in progress” (gwinprog) queue for processing. 


The MTA for the sender’s domain communicates the Transferred status 
message to the POA for the sender’s post office by way of TCP/IP. 


The POA for the sender’s post office updates the sender's message database 
(msgnnn. db) with the Transferred status information. 


The POA for the sender’s post office communicates the Transferred status to the 
sender's GroupWise client by way of TCP/IP. 


When the sender checks the sent items in his or her mailbox in the GroupWise 
client, the message displays the Transferred status because the Internet Agent 
was able to send it successfully. 


4.3 Mapped/UNC Link: Outbound Transfer to the Internet 


Successful 


This message flow diagram shows how outbound messages travel through the GroupWise directory 
structure to the Internet when there is a mapped/UNC link between the MTA and the Internet Agent 
and when the Internet Agent can communicate successfully with the Internet host to which the 
message is addressed. 
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Figure 4-3 Message Flow When the Mapped Link is Open 
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Table 4-3 Message Flow When the Mapped Link is Open Stages 


Stage Icon 


O Sender a 


© Sender's 
GroupWise S 
Client 


6) POA for 
Sender's Post x 
Office 


© POA for 
Sender’s Post Poa 
Office 


Description 


The user sends a message to recipients across the Internet by providing their 
Internet addresses. 


In this diagram, the access mode setting for the local post office is Client/Server 
Only. 


The GroupWise client communicates the message to the POA by way of TCP/ 
IP. 


The POA receives the message from the GroupWise client and performs the 
following actions for the sender: 


+ Adds the message to the message database (msgnnn. db) assigned to the 
sender. 


+ Creates a pointer in the sender's user database (userxxx. db) so the 
message appears in the sender’s mailbox as a sent item. 


+ Places attachments larger than 2 KB in one of the 
post_office\offiles\fd0-Fé subdirectories and creates pointers 
from the message to its attachments. (For database efficiency, messages 
and distribution lists larger than 2 KB are also handled as attachments.) 


+ Creates a copy of the message in the appropriate priority 0-7 subdirectory 
of the MTA input queue in the sender's post office, in case the TCP/IP link 
to the MTA is currently closed. 


The POA then communicates the message to the MTA for the sender’s domain 
by way of TCP/IP, and deletes the copy in the MTA input queue because the 
TCP/IP transfer to the MTA was successful. 
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Stage 


© MIA for 
Sender's 
Domain 


O MTA for 
Sender's 
Domain 


@ Internet 
Agent for 
Sender's 
Domain 


© Internet 
Agent for 
Sender's 
Domain 


O Internet 
Agent for 
Sender's 
Domain 


@ MTA for 
Sender's 
Domain 


@® MTA for 
Sender's 
Domain 


®© POA for 
Sender’s Post 
Office 


® POA for 
Sender's Post 
Office 


@ Sender 


GWIA 


GWIA 


MTA 


MTA 


5% 


POA 


POA 


E 


Description 


The MTA for the sender's domain receives the message and places it into the 
MTA “in progress” (gwinprog) queue. 


The MTA determines that the message must be sent out across the Internet. 
Because there is a mapped/UNC link between the MTA and the Internet Agent, 
the MTA places the message in its output queue in the Internet Agent's gateway 
directory (domain\wpgate\gwia\wpcsout \gwid\ 0-7). 


The Internet Agent scans its input queues according to the /dle Sleep Duration 
setting on the Gateway Time Settings page of the Internet Agent object in 
ConsoleOne. The Internet Agent picks up the file in binary-encrypted format 
from the wpcsout \gwid\ 0-7 directory and converts it. 


The Internet Agent encodes the message in MIME format with the appropriate 
encoding scheme. 


When the message file is built, the Internet Agent saves it with S as the first 
character of the filename and places the message file in the 
domain\wpgate\gwia\send directory for processing. 


While the Internet Agent is processing the message file in the send directory, it 
changes the first character of the filename to P. When processing is completed, 
the Internet Agent sends the message to the destination host across the 
Internet. 


If the Internet Agent receives a 250 OK SMTP reply code from the destination 
Internet host, it places a Transferred status message into the input queue of the 
MTA for the sender’s domain. 


Because of its mapped/UNC link with the Internet Agent, the MTA regularly 
scans its input queue in the Internet Agent's gateway directory based on the 
Scan Cycle setting on the Agent Settings page of the MTA object in 
ConsoleOne. It picks up the Transferred status messages and transfers them to 
its “in progress“ (gwinprog) directory for processing. 


The MTA for the sender's domain communicates the Transferred status 
messages to the POA for the sender's post office by way of TCP/IP. 


The POA for the sender's post office updates the sender's message database 
(msgnnn. db) with the Transferred status information. 


The POA for the sender’s post office communicates the Transferred status to the 
sender’s GroupWise client by way of TCP/IP. 


When the sender checks the sent items in his or her mailbox in the GroupWise 
client, the message displays the Transferred status because the Internet Agent 
was able to sent it successfully. 


40 GroupWise 8 Troubleshooting 3: Message Flow and Directory Structure 


4.4 


Mapped/UNC Link: Outbound Transfer to the Internet 


Delayed or Unsuccessful 


This message flow diagram shows how outbound messages travel through the GroupWise directory 
structure to the Internet when there is a mapped/UNC link between the MTA and the Internet Agent 


and when the Internet Agent cannot communicate successfully with the Internet host to which the 


message is addressed. 


Figure 4-4 Message Flow When the Mapped Link is Closed 


Table 4-4 Message Flow When the Mapped Link is Closed Stages 
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Internet addresses. 


In this diagram, the access mode setting for the local post office is Client/Server 
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© The GroupWise client communicates the message to the POA by way of TCP/ 
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Stage 


© POA for 
Sender's Post 
Office 


© POA for 
Sender’s Post 
Office 


© MIA for 
Sender's 
Domain 


O MIA for 
Sender's 
Domain 


@ Internet 
Agent for 
Sender's 
Domain 


O Internet 
Agent for 
Sender's 
Domain 


O Internet 
Agent for 
Sender's 
Domain 


Icon 


5% 


POA 


5% 


POA 


GWIA 


GWIA 


Description 


The POA receives the message from the GroupWise client and performs the 
following actions for the sender: 


+ Adds the message to the message database (msgnnn. db) assigned to the 
sender. 


+ Creates a pointer in the sender's user database (userxxx. db) so the 
message appears in the sender's mailbox as a sent item. 


+ Places attachments larger than 2 KB in one of the 
post_office\offiles\fd0-F6 subdirectories and creates pointers 
from the message to its attachments. (For database efficiency, messages 
and distribution lists larger than 2 KB are also handled as attachments.) 


+ Creates a copy of the message in the appropriate priority 0-7 subdirectory 
of the MTA input queue in the sender's post office, in case the TCP/IP link 
to the MTA is currently closed. 


The POA then communicates the message to the MTA for the sender’s domain 
by way of TCP/IP, and deletes the copy in the MTA input queue because the 
TCP/IP transfer to the MTA was successful. 


The MTA for the sender’s domain receives the message and places it into the 
MTA “in progress” (gwinprog) queue. 


The MTA determines that the message must be sent out across the Internet. 
Because there is a mapped/UNC link between the MTA and the Internet Agent, 
the MTA places the message in its output queue in the Internet Agent’s gateway 
directory (domain\wpgate\gwia\wpcsout \gwid\ 0-7). 


The Internet Agent scans its input queues according to the /dle Sleep Duration 
setting on the Gateway Time Settings page of the Internet Agent object in 
ConsoleOne. The Internet Agent picks up the file in binary-encrypted format 
from the wpcsout \gwid\ 0-7 directory and converts it. 


The Internet Agent encodes the message in MIME format with the appropriate 
encoding scheme. 


When the message file is built, the Internet Agent saves it with S as the first 
character of the filename and places the message file in the 
domain\wpgate\gwia\send directory for processing. 


While the Internet Agent is processing the message file in the send directory, it 
changes the first character of the filename to P. When processing is completed, 
the Internet Agent sends the message to the destination host across the 
Internet. 


If the Internet Agent does not receive a 250 OK SMTP reply code from the 
destination Internet host, the Internet Agent renames the P* . * message file 
back to S* . * and creates a file named R* . * that records the SMTP reply codes 
(error messages) in the wogate\gwia\result directory. After the Internet 
Agent completes the communication with the destination host, it moves the 

S* .* message file from the send directory to the result directory along with the 
corresponding R* . * file. 
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Stage 


O Internet 
Agent for 
Sender's 
Domain 


O Internet 
Agent for 
Sender's 
Domain 


@ Internet 
Agent for 
Sender's 
Domain 


® MTA for 
Sender's 
Domain 


®© MTA for 
Sender's 
Domain 


® POA for 
Sender's Post 
Office 


D POA for 
Sender’s Post 
Office 


@ Sender 


Icon 


GWIA 


= 


MTA 


MTA 


POA 


SY 


POA 


E 


Description 


The Internet Agent analyzes the files in the result directory, comparing the 
SMTP reply codes in the R* . * file. 


If the R* . * file has a temporary transmission error (meaning it has a 400-level 
SMTP reply code such as 450 Host Down), the Internet Agent moves the S*. * 
message file to the defer directory. Continue with Stage (Y) 


If the R* . * file has a fatal error (meaning it has a 500-level SMTP reply code 
such as 550 Host Unknown), the Internet Agent deletes the S* . * file because it 
is undeliverable. Skip to Stage @ 


Based on the /ntervals to the Retry a Deferred Message setting on the SMTP/ 
MIME Settings property page of the Internet Agent object in ConsoleOne, the 
Internet Agent requeues the S *.* message file back into the send directory for 
reprocessing. 


After an S* . * message receives 400-level SMTP reply codes until the 
Maximum Number of Hours to Retry a Deferred Message setting is reached, or 
if a message receives 500-level SMTP reply codes, the Internet Agent deletes 
all related schedule files from the defer directory because the message is 
undeliverable. The Internet Agent then creates an Undeliverable status 
message for the MTA to pick up and return to the sender. 


Because of its mapped/UNC link with the Internet Agent, the MTA scans its input 
queue in the Internet Agent’s gateway directory based on the Scan Cycle setting 
on the Agent Settings page of the MTA object in ConsoleOne. The MTA picks up 
the Undeliverable status messages and transfers them to its “in progress“ 
(gwinprog) directory for processing. 


The MTA for the sender’s domain communicates the Transferred status 
messages to the POA for the sender's post office by way of TCP/IP. 


The POA for the sender’s post office updates the sender's message database 
(msgnnn. db) with the Transferred status information. 


The POA for the sender’s post office communicates the Transferred status to the 
sender's GroupWise client by way of TCP/IP. 


When the sender checks the sent items in his or her mailbox in the GroupWise 
client, the message displays the Transferred status because the Internet Agent 
was able to send it successfully. 


TCP/IP Link: Inbound Transfer from the Internet Successful 


This message flow diagram illustrates how inbound message flow from the Internet through the 
GroupWise directory structure to the GroupWise recipient. The link between the Internet Agent and 
the MTA for the recipient’s domain is a TCP/IP link. 
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Figure 4-5 Message Flow in From the Internet 
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Table 4-5 Message Flow in From the Internet Stages 


Stage 


O Internet 
Agent for 
Recipient's 
Domain 


O Internet 
Agent for 
Recipient's 
Domain 


© Internet 
Agent for 
Recipient's 
Domain 


© MIA for 
Recipient’s 
Domain 


© MTA for 
Recipient’s 
Domain 


O MTA for 
Recipient's 
Domain 


Actor 


GWIA 


GWIA 


GWIA 


Action 


An Internet user sends a message to a GroupWise user. The Internet Agent 
receives the message from the external Internet host and places the message 
file in the wogate\gwia\receive directory. 


The Internet Agent polls the receive directory according to the Idle Sleep 
Duration setting on the Gateway Time Settings page of the Internet Agent object 
in ConsoleOne. It picks up the message file, converts it to GroupWise format, 
and places a copy in the wogate\ gwia\wpcsin\ 0-7 directory, where 0-7 is 
one of the priority subdirectories from 0-7. The Internet Agent puts messages 
only in the 4 directory, used for normal priority messages. 


The Internet Agent then communicates the message to the MTA for the 
recipient’s domain by way of TCP/IP. When the transmission is successful, it 
deletes the copy in the in the wogate\gwia\wpcsin\ 0-7 directory. 


The MTA for the recipient’s domain receives the message and places it into the 
MTA “in progress” (gwinprog) queue. 


The MTA determines which post office in the domain the recipient is located in, 
then moves the message to that post office’s hold queue 
(mslocal\mshold\postx\ 0-7). 


The MTA for the recipient’s domain then communicates the message to the POA 
in the recipient's post office by way of TCP/IP. 
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Stage Actor Action 


@ POA for When it receives the new message, the POA for the recipient's post office 
Recipient's POA performs the following actions: 
Post Office 


+ Adds the message to the message database (msgnnn. db file) 
corresponding to the one assigned to the sender. 


+ Creates a pointer in the recipient's user database (userxxx. db file), so 
the message appears in the recipient's Mailbox and updates the 
notification information in the user database so the recipient can be notified 
of the message. 


+ Places attachments larger than 2 KB in one of the 
post_office\offiles\fd0-F6 subdirectories and creates pointers 
from the message to its attachments. (For database efficiency, messages 
and recipient lists larger than 2 KB are also handled as attachments.) 


© Recipient's & The Notify component of the recipient's GroupWise client notifies the recipient 
GroupWise that a new message has arrived. 
Client 


© Recipient Pen Each recipient opens the message in the GroupWise client. 


Mapped/UNC Link: Inbound Transfer from the Internet 
Successful 


This message flow diagram illustrates how inbound message flow from the Internet through the 
GroupWise directory structure to the GroupWise recipient. The link between the Internet Agent and 
the MTA for the recipient's domain is a mapped/UNC link. 


Figure 4-6 Message Flow in From the Internet 
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Table 4-6 Message Flow in From the Internet Stages 


Stage 


O Internet 
Agent for 
Recipient's 
Domain 


© Internet 
Agent for 
Recipient's 
Domain 


© MTA for 
Recipient's 
Domain 


O MTA for 
Recipient's 
Domain 


© MIA for 
Recipient’s 
Domain 


O POA for 
Recipient's 
Post Office 


@ Recipient's 
GroupWise 


Client 


© Recipient 


Actor 


GWIA 


GWIA 


MTA 


S 
& 


Action 


An Internet user sends a message to a GroupWise user. The Internet Agent 
receives the message from the external Internet host and places the message 
file in the wogate\gwia\receive directory. 


The Internet Agent polls the receive directory according to the Idle Sleep 
Duration setting on the Gateway Time Settings page of the Internet Agent object 
in ConsoleOne. It picks up the message file, converts it to GroupWise format, 
and places it in the wogate\gwia\wpcsin\ 0-7 directory, where 0-7 is one of 
the priority subdirectories from 0-7. The Internet Agent puts messages only in 
the 4 directory, used for normal priority messages. 


The MTA polls the domain\wpgate\gwia\wpcsin\fd0-7F directory based 
on the Scan Cycle setting on the Agent Settings page of the MTA object in 
ConsoleOne. It picks up the message file and moves it to its “in progress” 
(gwinprog) queue. 


The MTA determines which post office in the domain the recipient is located in, 
then moves the message to that post office’s hold queue 
(mslocal\mshold\postx\ 0-7). 


The MTA for the recipient’s domain then communicates the message to the POA 
in the recipient's post office by way of TCP/IP. 


When it receives the new message, the POA for the recipient’s post office 
performs the following actions: 


+ Adds the message to the message database (msgnnn. db file) 
corresponding to the one assigned to the sender. 


+ Creates a pointer in the recipient's user database (userxxx. db file), so 
the message appears in the recipient's Mailbox and updates the 
notification information in the user database so the recipient can be notified 
of the message. 


+ Places attachments larger than 2 KB in one of the 
post_office\offiles\fd0-Fé subdirectories and creates pointers 
from the message to its attachments. (For database efficiency, messages 
and recipient lists larger than 2 KB are also handled as attachments.) 


The Notify component of the recipient's GroupWise client notifies the recipient 
that a new message has arrived. 


Each recipient opens the message in the GroupWise client. 
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9.1 


Message Delivery through a Modem 
Connection 


GroupWise client users can still access information in their mailboxes even when not connected to 
the network by running the GroupWise client in Remote mode. 


+ Section 5.1, ““Hit the Road” Process in Online Mode,” on page 47 
+ Section 5.2, “Modem Link through the Async Gateway in Remote Mode,” on page 48 


“Hit the Road” Process in Online Mode 


This message flow diagram illustrates how a user who will be away from the network prepares to 
access GroupWise from a remote location by downloading mailbox contents. 


Figure 5-1 Message Flow for Hit the Road 
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Table 5-1 Message Flow for Hit the Road Stages 


Stage Icon Description 


O Remote Á The GroupWise user runs Hit the Road in Online mode in order to request items 

User from the master mailbox to be downloaded to the Remote mailbox in preparation 
for disconnecting from the master GroupWise system. For example, the user 
could be preparing a laptop computer for use away from the network. 
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Stage Icon Description 


12) ® The GroupWise client prompts the user for the location to create the Remote 
GroupWise mailbox and the types of items to download, then it transfers the request to the 
Client in POA. 

Online Mode 


© POA for SO The POA receives the request from the GroupWise client and performs the 


Remote POR following actions: 

User's Post 

Office + Gathers all folders from the GroupWise user's master mailbox (msgnnn. db 
and userxxx. db) so that it has somewhere to put the items requested by 
the user. 


+ Gathers the requested items from the GroupWise user's master mailbox. 


+ Gathers any attachments for requested items from the 
post_office\offiles\fd0-F6 subdirectories in the GroupWise user's 
post office. 


+ Gathers any other types of information requested by the GroupWise user, 
such as rules, address books, documents, and junk mail lists. 


© POA for The POA compiles the information into a response file and transfers the response 
Remote POA to the GroupWise client. 

User's Post 

Office 

O © The GroupWise client receives the response and performs the following actions 
GroupWise for the GroupWise user: 

Client in 

Online Mode + Updates the GroupWise Remote message database (msg . db) with any 


items requested from the user's master mailbox. 


+ Creates pointers in the GroupWise Remote user database (user . db) so 
the messages gathered from the master mailbox appear in the user's 
GroupWise mailbox when running in Remote mode. 


+ Places any requested attachments larger than 2 KB in the rofdata 
directory and creates pointers from the message to its attachments. (For 
database efficiency, messages and distribution lists larger than 2 KB are 
also handled as attachments.) 


+ Updates the Remote mailbox with any other types of information requested 
by the GroupWise user. 


The user's GroupWise Remote mailbox now contains current copies of requested 
items from the user's master mailbox. 


O Remote aa The GroupWise client restarts in Remote mode and accesses the new Remote 

User mailbox. The GroupWise user can now review current GroupWise mail in Remote 
mode after the connection to the master GroupWise system is no longer 
available. 


5.2 Modem Link through the Async Gateway in Remote Mode 


This message flow diagram illustrates how a GroupWise user in Remote mode can access the master 
GroupWise system through the GroupWise Async Gateway. 
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Figure 5-2 Message Flow Through a Modem 
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Table 5-2 Message Flow Through a Modem Stages 


Stage 


O Remote 
User 


12] 
GroupWise 
Client in 
Remote 
Mode 


Icon 


& 


Description 


The GroupWise user, who is working in Remote mode, sends a message to 
another GroupWise user or creates a request for items from the master mailbox. 
The remote user's computer is not currently connected to the network or the 
user's master GroupWise system. 


When the remote GroupWise user sends a message to another GroupWise user, 
the GroupWise client performs the following actions in the user's Remote 
mailbox: 


+ Adds the message to the message database (msg. db) on the user's 
remote computer. 


+ Creates a pointer in the user database (user . db) so the message appears 
as a sent item in the Remote mailbox on the user’s remote computer. 


+ Places attachments larger than 2 KB in the rofdata directory and creates 
pointers from the message to its attachments on the user’s remote 
computer. (For database efficiency, messages and distribution lists larger 
than 2 KB are also handled as attachments.) 


+ Creates a copy of the message in the wocsin\1 subdirectory of the 
GroupWise client’s remote input queue on the user’s remote computer. 


When the remote GroupWise user sends a request for items from the master 
mailbox to be downloaded to the Remote mailbox, the GroupWise client places 
the request in the wocsin\1 subdirectory of the GroupWise client's remote input 
queue on the user’s remote computer. 
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50 


Stage Icon 


O 
GroupWise B 


Client in 
Remote 
Mode 


O: 
GroupWise S 


Client with 
Modem 
Connection 


© Async 
Gateway 


O Async 
Gateway 


@ Async 
Gateway 


© MTA for SO 
Remote HTA 
User's 

Domain 


© MIA for SO 
Remote HTA 
User's 

Domain 


Description 


When the remote GroupWise user initiates the modem connection, the 
GroupWise client polls its input queue (wocsin\1) and compresses the outgoing 
messages and/or requests into a file. If the compressed file totals over 50 KB, 
additional compressed files are created. 


The GroupWise client moves the compressed message/request files into its 
output queue (wpgwsend) directory. 


The GroupWise client dials in to the gateway, logs in, then transmits the 
compressed message/request files across the modem connection to the 
GroupWise Async Gateway in the GroupWise system where the user’s master 
mailbox is located. 


The GroupWise Async Gateway receives the message/request files and places 
them into it input queue 
(wogate\async\asyxxx\gwin\connection_id\cmp) for processing. 


The Async Gateway decompresses the message/request files and moves them 
into the subdirectory for the remote user’s connection with the master GroupWise 
system. 


With a TCP/IP link, the Async Gateway transfers the decompressed files to the 
MTA for the remote user’s domain in the master GroupWise system. 


With a UNC/mapped link, the Async Gateway places the message/request files 
into the MTA’s input queue (wogate\async\wpcsin\1), where the MTA picks 
up the files. 


The MTA for the remote user’s domain receives the message/request files and 
places them into the MTA “in progress” (gwinprog) queue. 


The MTA for the remote user’s domain then communicates the message/request 
files to the POA for the post office where the remote user’s master mailbox is 
located. 


NOTE: This message flow diagram illustrates only the simplest case where the 
recipient is in the same post office as the remote user's master mailbox. If the 
remote user sends a message to a user in any other post office, the MTA routes 
the message to the appropriate destination. 
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Stage Icon Description 


D POA for 4 When the POA receives a message from the remote user, the POA performs the 


Remote POA following actions to update the remote user’s master mailbox: 
User’s Post 
Office + Adds the message to the remote user's message database (msgnnn. db) in 


the Online mailbox. 


+ Creates a pointer in the recipient’s user database (userxxx. db) in the 
Online mailbox so that the new message appears in the recipient’s mailbox 
and updates the notification information in the user database so the 
recipient can be notified of the message. 


+ Places attachments larger than 2 KB in one of the 
post_office\offiles\fd0-F6 subdirectories in the remote user's post 
office and creates pointers from the message to its attachments. (For 
database efficiency, messages and distribution lists larger than 2 KB are 
also handled as attachments.) 


+ Creates a Delivered status message in the priority 1 subdirectory of the 
remote user's MTA input queue (wpcsin) in the post office. 


When the POA receives a request for items from the remote user’s master 
mailbox, the POA performs the following actions: 


+ Gathers the requested items from the remote user's master mailbox 
(msgnnn. db). 


+ Gathers any attachments for requested items from the 
post_office\offiles\fd0-F6 subdirectory in the remote user's post 
office. 


+ Compiles the information into a response file and places it in the priority 1 
subdirectory of the MTA input queue for return to the remote user. 


® POA for 5% The POA for the remote user's post office communicates the Delivered status for 


Remote POA messages and the response file for requests to the MTA for the remote user’s 
User's Post domain. When the transfer is successful, the copies in the MTA input queue are 
Office deleted. 

® MTA in SO The MTA for the remote user's domain places the status/response files into the 
Remote HTA MTA “in progress” (gwinprog) queue. 

User's 

Domain 


® MTA in SL With a TCP/IP link, the MTA for the remote user's domain communicates the 


Remote HTA status/response files to the Async Gateway in the remote user's domain. 
User's 
Domain With a UNC/mapped link, the MTA for the remote user's domain places the 


status/response files into the Async Gateway's input queue 
(wpgatelasynclasyxxxlwpcsout11), where the Async Gateway picks up 
the files. 


When the MTA in the GroupWise Remote user’s domain detects the response for 
the GroupWise Remote user, the MTA picks it up from its post office input queue 
and transfers it to its output queue in the Async Gateway directory under wpgate 
in the GroupWise Remote user's domain. The MTA output queue in the Async 
Gateway directory is the input queue for the Async Gateway. 


@ Async = The Async Gateway places the status/response files into the MTA output queue 
Gateway (wogate\async\wpcsout \asyxxx\connection_id\1) of the Async 
Gateway directory. 
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52 


Stage Icon 


® Async + 


Gateway 


© Async 
Gateway 
with Modem 
Connection 


(17 
GroupWise S 


Client in 
Remote 
Mode 


O 
GroupWise S 


Client in 
Remote 
Mode 


®© Remote a 


User 


Description 


If the modem connection to the remote user is still active, the Async Gateway 
compresses the status/response files and moves them to the cmp directory. 


If the modem connection is no longer available, the status/response files wait in 
the connection_id\1 subdirectory until a new connection is established by the 
remote user. 


The Async Gateway transmits the status/response files through the modem 
connection to the input queue (wogwrecv) for the GroupWise client on the user’s 
remote computer. 


The GroupWise client on the remote computer decompresses the status/ 
response files and places them in its input queue (wocsout \ofs\1) on the 
user's remote computer. 


Taking the items from its input queue, the GroupWise client performs the 
following actions to update the Remote mailbox on the user's remote computer: 


+ Updates the message database (msg. db) with any items requested from 
the remote user's master mailbox. 


+ Creates pointers in the user database (user . db) so the messages 
gathered from the master mailbox appear in the Remote mailbox. 


+ Places any requested attachments larger than 2 KB in the rofdata directory 
and creates pointers from the message to its attachments. (For database 
efficiency, messages and distribution lists larger than 2 KB are also handled 
as attachments.) 


+ Updates the remote Address Book (wprof . db) to synchronize it with the 
Address Book in the remote user's master GroupWise system. 


The user's Remote mailbox now contains current copies of requested items from 
the remote user's master mailbox, plus any messages received in the user's 
master mailbox from other GroupWise users. 


The GroupWise user can now review current GroupWise mail when the modem 
connection to the master GroupWise system is no longer available. 


GroupWise 8 Troubleshooting 3: Message Flow and Directory Structure 


Administrative Database Update 


ConsoleOne and the agents handle database updates throughout the GroupWise system. 


This message flow diagram illustrates how an administrative message, such as a database update 
request, passes from ConsoleOne to the agents so that databases are updated throughout the 
GroupWise system. 


Figure 6-1 Administrative Message Flow through TCP/IP 
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Table 6-1 Administrative Message Flow through TCP/IP Stages 


Stage 


O GroupWise 
Administrator 


2] 


ConsoleOne 


© MTA for 
Domain 


© POA for 
Post Office 


© POA for 
Post Office 


Actor 


E 


C 


MTA 


Action 


The administrator uses the GroupWise Administrator snap-in in ConsoleOne to 
add, modify, or delete a GroupWise object in a single-domain, single-post office 
GroupWise system. 


An object could be a GroupWise user, resource, distribution list, post office, 
secondary domain, and so on. 


ConsoleOne performs the following actions: 


+ Updates the domain database (wpdomain . db) to reflect the addition, 
modification, or deletion performed in ConsoleOne. 


+ Creates an administrative message in the priority 2 subdirectory of the 
domain's MTA input queue (wpcsin) to replicate the update. 


The MTA for the domain transfers the administrative message to the MTA “in 
progress” (gwinprog) queue. From there, the MTA communicates the 
administrative message to the POA in the post office by way of TCP/IP. The 
administrative message notifies the POA that a GroupWise object has been 
added, modified, or deleted. 


Historical Note: In earlier versions of GroupWise, this function of the POA was 
handled by a separate agent, the Administration Agent (ADA). The ADA no 
longer exists in GroupWise. 


The POA creates a copy of the administrative message in the priority 2 
subdirectory of the administrative input queue (wpcsout \ads) in the post office. 
After the update is made successfully, the copy is deleted. 


The POA updates the post office database (wphost . db) to reflect the addition, 
modification, or deletion performed in ConsoleOne and deletes the 
administrative message from its administrative input queue. 
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Directory Structure Diagrams 


This part of Troubleshooting 3: Message Flow and Directory Structure helps you understand the structure 
of GroupWise message transfer/storage directories (such as domains and post offices) and software 
installation directories. 

+ Chapter 7, “Message Transfer/Storage Directories,” on page 57 

+ Chapter 8, “Agent Installation Directories,” on page 99 

¢ Chapter 9, “Web Application Installation Directories on Your Web Server,” on page 133 

¢ Chapter 10, “Software Distribution Directory,” on page 157 

+ Chapter 11, “GroupWise Client Installation Directories,” on page 173 
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Message Transfer/Storage Directories 


Message transfer and storage directories are the locations through which messages pass as they 
travel from user to user through your GroupWise system. 

¢ Section 7.1, “Domain Directory,” on page 57 

è Section 7.2, “Post Office Directory,” on page 64 

+ Section 7.3, “MTA Local Queue Directory,” on page 77 

+ Section 7.4, “WebAccess Agent Queue Directory,” on page 81 

+ Section 7.5, “Internet Agent Queue Directory,” on page 83 

+ Section 7.6, “Caching Mailbox Directory,” on page 89 

+ Section 7.7, “Remote Mailbox Directory,” on page 94 


Domain Directory 


EN] domain Domain directory 
HA] mslocal MTA local working directory 
E] wpcsin MTA input queue directory 
Bl o Live interactive requests 
MN 1 Other interactive requests 
$ 2 High priority messages 
im: High priority status responses 
CE Normal priority messages 
Ms Normal priority status responses 
E Low priority messages 
Š 7 Low priority status responses 
HA] wptools Supporting program directory 
HA] wpgate GroupWise gateway directory 
E wpcsout MTA output queue directory 
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Ml ads MTA admin thread input queue directory 


Hl o Restart requests 

1 Directory synchronization requests 

Bl 2 Database updates 

eS 3 Reserved; not currently used 

E Reserved; not currently used 

is Reserved; not currently used 

Wc Reserved; not currently used 

7 Reserved; not currently used 

css MTA input queue directory for administrative messages 

o MTA restart requests 

i Statistics requests 

CB Other non-priority administrative requests 

E Reserved; not currently used 

E Reserved; not currently used 

Gs Reserved; not currently used 

BN 6 Reserved; not currently used 

E 7 Reserved; not currently used 

@ problem Directory for undeliverable messages 

_] mtaname Domain name identifier 
_] wpdomain.db Domain database 
_] wpdomain. dc Data dictionary for 4.x domain databases 
_] wphost .de Data dictionary for 4.x post office databases 
Jj gwdom. dc Data dictionary for 5.x, 6.x, 7, and 8. domain databases 
Ll gwpo.dc Data dictionary for 5.x, 6.x, 7, and 8. post office databases 
_] viewcopy.log Log file recording view file updates for post offices 


7.1.1 domain directory 


Within the GroupWise system, a domain is hierarchically the highest level object. It organizes post 
offices into a logical grouping for addressing and routing purposes. Each user in the domain has an 
address that consists of the user’s GroupWise user ID, the user’s post office name, and the domain 
name (user. post_office. domain). The explicit name is not displayed in the Address Book, but is 
stored in the domain database (wpdomain. db). 


7.1.2 wpcsin directory 


The wpcsin subdirectory in the domain is the MTA input queue in each domain. It contains eight 
priority subdirectories to handle different types of message traffic. 


+ Incoming user messages are queued by priority for routing to recipients’ post offices in the local 
domain. 


+ Incoming status messages are queued by priority for routing to senders’ post offices in the local 
domain. 


+ Outgoing administrative messages are queued for replication to other domains. 


+ Ina routing domain, messages pass through this directory on their way to the next domain. 
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When a new message arrives, the MTA routes it to the appropriate destination. 


For TCP/IP links, the MTA is notified immediately when a message arrives for processing. For 
mapped and UNC links, the MTA scans its input queue for messages to process. You can control the 
rate at which the MTA scans its input queues. See “Adjusting MTA Polling of Input Queues in the 
Domain, Post Offices, and Gateways” in “Optimizing the MTA” in the GroupWise 8 Administration 
Guide. 


Historical Note: WP Office, the predecessor of GroupWise, was originally designed by WordPerfect 
Corporation (WPCorp). The Message Transfer Agent (MTA) was originally named the Connection 
Server (CS). Hence, the directory name wpcsin for the MTA input queue. Some naming conventions 
were originally preserved for backward compatibility. 


0 directory 


The priority 0 subdirectory of the MTA input queue (wocsin) in the domain is for service requests 
that demand an immediate response from the MTA. For example: 


+ ConsoleOne places restart requests and queue reconfiguration requests here for the MTA and 
gateways. 

+ MTAs for other domains route Busy Search requests through here when users in other domains 
check schedules of users in the local domain. 


You can increase throughput for the priority 0 subdirectory. See “Adjusting the Number of MTA 
Scanner Threads for the Domain and Post Offices” in “Optimizing the MTA” in the GroupWise 8 
Administration Guide. 


1 directory 


The priority 1 subdirectory of the MTA input queue (wpcsin) in the domain is for service requests of 
the next highest priority. For example: 
+ ConsoleOne places directory synchronization requests here for the MTA admin thread. 


+ ConsoleOne places statistics requests here for the MTA to relay to the message logging module 
for processing. 


+ MTAs for other domains route remote GroupWise client requests through here when remote 
GroupWise users do not connect to the post office where their master mailboxes are located. 


You can increase throughput for the priority 1 subdirectory. See “Adjusting the Number of MTA 
Scanner Threads for the Domain and Post Offices” in “Optimizing the MTA” in the GroupWise 8 
Administration Guide. 


2 directory 


The priority 2 subdirectory of the MTA input queue (wpcsin) in the domain is for high priority 
messages. For example: 


+ MTAs for other domains place incoming high priority user messages here. The local MTA then 
routes the messages to recipients’ post offices. 


¢ MTAs for other domains place incoming administrative messages here to replicate database 
updates in the local domain. 


¢ The MTA admin thread places outgoing administrative messages here to replicate database 
updates to other domains. 
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You can increase throughput for the priority 2 and 3 subdirectories. See “Adjusting the Number of 
MTA Scanner Threads for the Domain and Post Offices” in “Optimizing the MTA” in the GroupWise 8 
Administration Guide. 


3 directory 


The priority 3 subdirectory of the MTA input queue (wpcsin) in the domain is for high priority status 
messages routed back to senders in local post offices. 


For example, MTAs for other domains place status responses to high priority user messages here. The 
local MTA then routes the status messages to senders’ post offices, so senders’ mailboxes can be 
updated with current message status. 


You can increase throughput for the priority 2 and 3 subdirectories. See “Adjusting the Number of 
MTA Scanner Threads for the Domain and Post Offices” in “Optimizing the MTA” in the GroupWise 8 
Administration Guide. 


4 directory 


The priority 4 subdirectory of the MTA input queue (wpcsin) in the domain is for normal priority 
user messages routed to recipients in local post offices. 


For example, MTAs for other domains place normal priority user messages here. The local MTA then 
routes the messages to recipients” post offices. Most messages in your GroupWise system pass 
through the priority 4 subdirectory. 


You can increase throughput for the priority 4 subdirectory. See “Adjusting the Number of MTA 
Scanner Threads for the Domain and Post Offices” in “Optimizing the MTA” in the GroupWise 8 
Administration Guide. 


5 directory 


The priority 5 subdirectory of the MTA input queue (wpcsin) in the domain is for normal priority 
status messages routed back to senders in local post offices. 


For example, MTAs for other domains place status responses to normal priority user messages here. 
The local MTA then routes the status messages to senders’ post offices, so senders’ mailboxes can be 
updated with current message status. 


6 directory 


The priority 6 subdirectory of the MTA input queue (wpcsin) in the domain is for low priority user 
messages routed to recipients in local post offices. 


For example, MTAs for other domains place low priority user messages here. The local MTA then 
routes the messages to recipients” post offices. 


7 directory 


The priority 7 subdirectory of the MTA input queue (wpcsin) in the domain is for low priority status 
messages routed back to senders in local post offices. 


For example, MTAs for other domains place status responses to low priority user messages here. The 
local MTA then routes the status messages to senders' post offices, so senders' mailboxes can be 
updated with current message status. 
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7.1.3 


7.1.4 


7.1.5 


wptools directory 


The wptools subdirectory in the domain contains programs that support GroupWise administration. 


Historical Note: WP Office, the predecessor of GroupWise, was originally designed by WordPerfect 
Corporation (WPCorp). Hence, the wp in wptools. Some naming conventions were originally 
preserved for backward compatibility. 


wpgate directory 


The wpgate subdirectory in the domain contains a subdirectory for each GroupWise gateway you 
have installed in your GroupWise system. For a list of gateways, see the GroupWise Gateways 
Documentation Web site (http://www.novell.com/documentation/gwgateways). GroupWise 5.5 
gateways can be used with GroupWise 6.x, 7, and 8. 


wpcsout directory 


The wpcsout subdirectory in the domain is the MTA output queue in each domain. It contains 
subdirectories that function as input queues for the processes to which the MTA delivers messages. 


Historical Note: WP Office, the predecessor of GroupWise, was originally designed by WordPerfect 
Corporation (WPCorp). The Message Transfer Agent (MTA) was originally named the Connection 
Server (CS). Hence, the directory name wpcsout for the MTA output queue. Some naming 
conventions were originally preserved for backward compatibility. 


ads directory 


The ads subdirectory of the MTA output queue (wpcsout) in the domain is the input queue for the 
MTA admin thread in each domain. It contains priority subdirectories where incoming 
administrative messages are queued for processing. When a new administrative message arrives, the 
MTA admin thread performs the requested action. 


Historical Note: The MTA admin thread was previously part of a separate agent, the Administration 
Agent (ADA), which was originally named the Administration Server (ADS). Hence, the directory 
name ads. Some naming conventions were originally preserved for backward compatibility. 


0 directory 


The priority 0 subdirectory of the MTA admin thread input queue (wpcsout \ads) in the domain is 
for service requests that demand an immediate response from the MTA admin thread. 


For example, when you create or delete a post office in ConsoleOne, a restart request is placed here. 
The domain MTA admin thread processes the request and then restarts. 


1 directory 


The priority 1 subdirectory of the MTA admin thread input queue (wpcsout \ads) in the domain is 
for service requests of the next highest priority. 
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2 directory 


The priority 2 subdirectory of the MTA admin thread input queue (wpcsout \ads) in the domain is 
for high priority administrative messages. For example: 


+ The MTA places administrative messages from other domains here. The administrative 
messages might instruct the MTA admin thread to add, modify, or delete users, post offices, or 
other objects in the domain. The MTA admin thread then processes the messages and makes the 
specified updates. 


+ When you use the Synchronize utility in ConsoleOne, a synchronization request is placed here. 
The MTA admin thread then resends the specified administrative messages to produce the 
required database updates. 


css directory 


The css subdirectory of the MTA output queue (wpcsout) in the domain is processed by a 
specialized MTA thread that responds to requests regarding its own configuration. It contains the 
eight standard priority subdirectories. 


Historical Note: In an earlier version of GroupWise, the Message Transfer Agent (MTA) was called 
the Connection Server (CS) and this specialized subprocess was called the Connection Server Server 
(css). Some naming conventions were originally preserved for backward compatibility. 


0 directory 


The priority 0 subdirectory of the CSS input queue (wpcsout\css) in the domain is for service 
requests that demand an immediate response from the MTA. 


For example, when you restart the MTA at the MTA agent console or in ConsoleOne, a restart request 
is placed here. The MTA processes the request and restarts. 


1 directory 


The priority 1 subdirectory of the CSS input queue (wpcsout\css) in the domain is for service 
requests of the next highest priority. 


For example, each time the statistics are updated on the MTA agent console, a statistics request is 
placed here. The MTA then gathers the statistics and displays them on the MTA agent console. 


2 directory 
The priority 2 subdirectory of the css input queue (wpcsout\css) in the domain is for non-priority 
requests. 


problem directory 


The problem subdirectory of the MTA output queue (wpcsout) in the domain is where the MTA 

places message files that cannot be delivered because they are damaged in some way. Message files in 
the problem directory must be handled by the GroupWise administrator. See “Message Is Dropped in 
the problem Directory in the Domain” in GroupWise 8 Troubleshooting 2: Solutions to Common Problems. 
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7.1.6 


7.1.7 


7.1.8 


7.1.9 


mtaname file 


The mtaname file in the domain provides the domain name associated with the domain directory 
structure. This can help you locate the domain information for the directory structure in ConsoleOne. 
It can also help you check links between MTAs. 


wpdomain.db file 


The wpdomain. db file in the domain is the domain database. It contains all administrative 
information for the domain. 


In the primary domain, the wpdomain. db file contains all administrative information for your entire 
GroupWise system (all its domains, post offices, users, and so on). Because the wpdomain. db file in 
the primary domain is so crucial, you should back it up regularly and keep it secure. (You can re- 
create your entire GroupWise system from the primary domain wpdomain. db file; however, if the 
primary domain wpdomain. db file becomes unusable, you can no longer make administrative 
updates to your GroupWise system.) 


In a secondary domain, the wedomain. db file contains administrative information about that 
secondary domain only. 


In GroupWise 8, 7, 6.x, and 5.x domains, the data dictionary for the wodomain. db file is the gwdom. de 
file. In GroupWise 4.x domains, the data dictionary is the wodomain. dc file. As a result, wodomain.db 
files have different structures (schemas) depending on whether they were created for 8/7/6.x/5.x or 
4.x domains. 


Historical Note: WP Office, the predecessor of GroupWise, was originally designed by WordPerfect 
Corporation (WPCorp). Hence, the wp in wpdomain . db. Some naming conventions were originally 
preserved for backward compatibility. 


wpdomain.dc file 


The wpdomain. dc file in the domain is the data dictionary for rebuilding GroupWise 4.x domain 
databases (wpdomain. db files) in secondary domains. 


If the wpdomain. dc file is missing from the primary domain, you cannot rebuild GroupWise 4.x 
secondary domains. The original wpdomain.dc file is located in the domain subdirectory of the 
software distribution directory or on the GroupWise 8 DVD or GroupWise 8 downloaded software 
image. 


Historical Note: WP Office, the predecessor of GroupWise, was originally designed by WordPerfect 
Corporation (WPCorp). Hence, the wp in wodomain.dc. Some naming conventions were originally 
preserved for backward compatibility. 


wphost.dc file 


The wphost . de file in the domain is the data dictionary for rebuilding GroupWise 4.x post office 
databases (wphost . db files). 


If the wphost . dc file is missing from a domain, you cannot rebuild GroupWise 4.x post offices in that 
domain. The original wphost . dc file is located in the domain directory of the software distribution 
directory or on the GroupWise 8 DVD or GroupWise 8 downloaded software image. 


Historical Note: WP Office, the predecessor of GroupWise, was originally designed by WordPerfect 
Corporation (WPCorp). Post offices were originally called hosts. Hence, the name wphost .dc. Some 
naming conventions were originally preserved for backward compatibility. 
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7.1.10  gwdom.dc file 


The gwdom. dc file in the domain is the data dictionary for creating and rebuilding GroupWise 8, 7, 
6.x, and 5.x domain databases (wpdomain. db files) in secondary domains. 


If the gwdom. dc file is missing from the primary domain, you cannot create or rebuild GroupWise 8/ 
7/6.x/5.x secondary domains. The original gwdom. de file is located in the domain directory of the 
software distribution directory or on the GroupWise distribution media. 


7.1.11  gwpo.dc file 


The gwpo. dc file in the domain is the data dictionary for creating and rebuilding GroupWise 8, 7, 6.x, 
and 5.x post office databases (wphost . db files). 


If the gwpo. dc file is missing from a domain, you cannot create or rebuild GroupWise 8/7/6/x/5.x post 
offices in that domain. The original gwpo. dc file is located in the domain directory of the software 
distribution directory or on the GroupWise distribution media. 


7.1.12  viewcopy.log file 


The viewcopy . log file in the domain is created by the GroupWise Installation program if you update 
the Windows client software and the Installation program is unable to copy the view files to any post 
offices in the domain. You can manually update the view files later, as described in “Refreshing the 
Client View Files in the Post Office” in “Post Offices” in the GroupWise 8 Administration Guide. 


7.2 Post Office Directory 


En post office Post office directory 
dal wpcsin MTA input queue directory 
Bn o Live interactive requests 
i Other interactive requests 
i 2 High priority messages 
3 High priority status responses 
BN 4 Normal priority messages 
is Normal priority status responses 
Wl 6 Low priority messages 
7 Low priority status responses 
el gwdms Document Management Services directory 
_] dmsh. db Shared Document Management Services database 
$ 11b0001-FF Library directories 
a dmxxnn01-FF. db Document databases 
HH] index QuickFinder index for library 
Ü archive Archive directory for library 
E docs Large document directory for library 
È £a00-FF Subdirectories for documents 
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E ofmsg 
O msgnnn.db 
LJ ngwdfr.db 
ES] guardbak 


HN] ofuser 
_] userxxx.db 
J PUXXXXX. db 
HH] index 


W 


offiles 
ME fao-£6 


EN] ofviews 


3 


E 


ofwork 
E] ofdirect 


Es] oftemp 
E gwdca 
È in 
Es] out 
E] problem 
E] log 


E defer 


J mmddpoa . nnn 
O wprof50.db 


Message database directory 

As many as 255 message databases 
Deferred message database 

Backup guardian database 


User database directory 

User databases (one per user) 
Databases for shared folders 
QuickFinder index for messages 


Attachment store directory 
Subdirectories for attachments 


GroupWise client view files 


GroupWise working directory 
Remote direct connection directory 


GroupWise temporary files 

Document Conversion Agent temporary files 
Document Conversion Agent input queue 
Document Conversion Agent output queue 
Document Conversion Agent quarantine 
Document Conversion Agent log files 


MTA output queue directory 


POA input queue directory 

Live interactive requests 

Other interactive requests 

High priority messages 

High priority status responses 
Normal priority messages 

Normal priority status responses 
Low priority messages 

Low priority status responses 
Directory to temporarily store deferred messages 
POA log files 

Downloadable system Address Book 


POA admin thread input queue directory 
Restart requests 

Directory synchronization requests 
Database updates 

Reserved; not currently used 

Reserved; not currently used 

Reserved; not currently used 

Reserved; not currently used 

Reserved; not currently used 
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E chk GWCheck working directory 


E 0-3 GWCheck priority subdirectories 
@ defer GWCheck subdirectory for deferred database maintenance requests 
el problem Directory for undeliverable messages 
_] wphost .db Post office database 
_] gwpo.de Data dictionary for GroupWise 8/7/6.x/5.x post office databases 
_] ngwguard.db Guardian database 
_] ngwguard.de Data dictionary for databases 
_] ngwguard. fbk Guardian database backup 
_] ngwguard.rfl Guardian database roll forward log 
_] ngwcheck . db GWCheck control database 


7.2.1  post_office directory 


Conceptually, a post office contains mailboxes for a set of network users. The users on the post office 
send and receive messages through their mailboxes. 


Physically, a post office is a directory structure on a network file server. The directory structure 
contains subdirectories and databases that store messages and the information used to distribute the 
messages. 


7.2.2  wpcsin directory 


The wpcsin subdirectory in the post office is the MTA input queue in each post office. It contains 
eight priority subdirectories to handle different types of message traffic. 
+ Outgoing user messages are queued by priority for routing to recipients in other post offices. 
+ Outgoing status messages are queued by priority for routing back to senders’ post offices. 


+ Outgoing Busy Search requests are queued for routing to other post offices so users’ schedules 
can be checked. 


+ Remote GroupWise client requests are queued for routing to remote GroupWise users’ master 
mailboxes. 


When a new message arrives, the MTA routes it to the appropriate destination. 


For mapped and UNC links, the MTA scans its input queue for messages to process. You can control 
the rate at which the MTA scans its input queues. See “Adjusting MTA Polling of Input Queues in the 
Domain, Post Offices, and Gateways” in “Optimizing the MTA” in the GroupWise 8 Administration 
Guide. 


For TCP/IP links, the POA passes messages to the MTA via TCP/IP. A copy is kept in the MTA input 
queue until the POA has successfully transferred the message. 


Historical Note: WP Office, the predecessor of GroupWise, was originally designed by WordPerfect 
Corporation (WPCorp). The Message Transfer Agent (MTA) was originally named the Connection 
Server (CS). Hence, the directory name wpcsin for the MTA input queue. Some naming conventions 
were originally preserved for backward compatibility. 
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0 directory 


The priority 0 subdirectory of the MTA input queue (wpcsin) in the post office is for service requests 
that demand an immediate response from the MTA. 


For example, the GroupWise client places Busy Search requests here. The MTA then routes the 
requests to the appropriate post offices, so users’ schedules can be checked. 


For mapped and UNC links, you can increase throughput for the priority 0 subdirectory. See 
“Adjusting the Number of MTA Scanner Threads for the Domain and Post Offices” in “Optimizing 
the MTA” in the GroupWise 8 Administration Guide. 


For TCP/IP links, the 0 subdirectory is used only if the POA is unable to immediately transfer the 
request to the MTA by way of the TCP/IP link. 


1 directory 


The priority 1 subdirectory of the MTA input queue (wpcsin) in the post office is for service requests 
of the next highest priority. For example: 


+ Remote with a direct connection places requests here for routing to remote GroupWise users’ 
master mailboxes. 

+ The POA places outgoing status messages to remote GroupWise users here for routing to the 
Async Gateway. 


For mapped and UNC links, you can increase throughput for the priority 1 subdirectory. See 
“Adjusting the Number of MTA Scanner Threads for the Domain and Post Offices” in “Optimizing 
the MTA” in the GroupWise 8 Administration Guide. 


For TCP/IP links, the 1 subdirectory is used only if the POA is unable to immediately transfer the 
service request to the MTA by way of the TCP/IP link. 


2 directory 


The priority 2 subdirectory of the MTA input queue (wpcsin) in the post office is for high priority 
user messages routed to recipients in other post offices, domains, or systems. 


For example, the GroupWise client places high priority user messages here. The MTA then routes the 
messages to the appropriate destinations. 


For mapped and UNC links, you can increase throughput for the priority 2 and 3 subdirectories. See 
“Adjusting the Number of MTA Scanner Threads for the Domain and Post Offices” in “Optimizing 
the MTA” in the GroupWise 8 Administration Guide. 


For TCP/IP links, the 2 subdirectory is used only if the POA is unable to immediately transfer the 
high priority user messages to the MTA by way of the TCP/IP link. 


3 directory 


The priority 3 subdirectory of the MTA input queue (wpcsin) in the post office is for high priority 
status messages routed back to senders in other post offices, domains, or systems. 


For example, the GroupWise client and local POA place status responses to high priority user 
messages here. The MTA then routes the status messages to the appropriate post offices, so senders’ 
mailboxes can be updated with current message status. 
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For mapped and UNC links, you can increase throughput for the priority 2 and 3 subdirectories. See 
“Adjusting the Number of MTA Scanner Threads for the Domain and Post Offices” in “Optimizing 
the MTA” in the GroupWise 8 Administration Guide. 


For TCP/IP links, the 3 subdirectory is used only if the POA is unable to immediately transfer the 
high priority status responses to the MTA by way of the TCP/IP link. 


4 directory 


The priority 4 subdirectory of the MTA input queue (wpcsin) in the post office is for normal priority 
user messages routed to recipients in other post offices, domains, or systems. 


For example, the GroupWise client places normal priority user messages here. The MTA then routes 
the messages to the appropriate destinations. Most messages in your GroupWise system pass 
through the priority 4 subdirectory. 


For mapped and UNC links, you can increase throughput for the priority 4 subdirectory. See 
“Adjusting the Number of MTA Scanner Threads for the Domain and Post Offices” in “Optimizing 
the MTA” in the GroupWise 8 Administration Guide. 


For TCP/IP links, the 4 subdirectory is used only if the POA is unable to immediately transfer the 
normal priority user messages to the MTA by way of the TCP/IP link. 


5 directory 


The priority 5 subdirectory of the MTA input queue (wpcsin) in the post office is for normal priority 
status messages routed back to senders in other post offices, domains, or systems. 


For example, the GroupWise client and local POA place status responses to normal priority user 
messages here. The MTA then routes the status messages to the appropriate post offices, so senders’ 
mailboxes can be updated with current message status. 


For TCP/IP links, the 5 subdirectory is used only if the POA is unable to immediately transfer the 
normal priority status responses to the MTA by way of the TCP/IP link. 


6 directory 


The priority 6 subdirectory of the MTA input queue (wpcsin) in the post office is for low priority user 
messages routed to recipients in other post offices, domains, or systems. 


For example, the GroupWise client places low priority user messages here. The MTA then routes the 
messages to the appropriate destinations. 


For TCP/IP links, the 6 subdirectory is used only if the POA is unable to immediately transfer the low 
priority user messages to the MTA by way of the TCP/IP link. 


7 directory 


The priority 7 subdirectory of the MTA input queue (wpcsin) in the post office is for low priority 
status messages routed back to senders in other post offices, domains, or systems. 


For example, the GroupWise client and local POA place status responses to low priority user 
messages here. The MTA then routes the status messages to the appropriate post offices, so senders’ 
mailboxes can be updated with current message status. 
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7.2.3 


For TCP/IP links, the 7 subdirectory is used only if the POA is unable to immediately transfer the low 
priority status responses to the MTA by way of the TCP/IP link. 


gwdms directory 


The gwdms subdirectory in the post office is the Document Management Services (DMS) directory in 
each post office. It contains the document libraries associated with the post office. 


dmsh.db file 


The dmsh. db file in the document management subdirectory (gwdms) in the post office is a database 
shared by all libraries in the post office. It contains a list of all available libraries and lookup tables for 
each library. 


lib0001-FF directories 


The 1ib0001-FF subdirectories in the gwdms subdirectory in the post office contain the libraries for 
the post office, with one library per directory. You can create a maximum of 256 libraries in a post 
office. 


dmxxnn01-FF.db files 


The dmxxnn01-FF.db files in the library subdirectories (1ib0001-££) in the post office are databases 
for library and document information. 


The nn in the filenames represents the partition number, which is generated by a hashing algorithm 
to guarantee uniqueness. 


The 01-ff in the filenames represents the library number, matching the number on the library 
directory in which the database is found. 


dmsdnn01-ff.db file The dmsdnn01-ff.db file in each library holds system data for the library, such 
as library configuration information. 


dmddnn01-ff.db file The dmddnno1-ff.db file in each library holds document data for the library. 
Document data is the document property information for documents in the library. 


dmdlnn01-ff.db file The dmd1nn01-£f.db file in each library holds document logging data for the 
library. Document logging data records all activities performed on documents in the library. 


index directory 


The index subdirectories in the library subdirectories (1ib0001- ff) in the post office contain the 
QuickFinder index for the documents contained in the library. 


archive directory 


The archive subdirectories in the library subdirectories (1ib0001-FF) in the post office contain an 
array of subdirectories for holding archived documents. The subdirectories are numbered 
sequentially. When the first archive subdirectory reaches its maximum allowable size, archived 
documents are stored in the next sequential directory, and so on. 
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docs directory 


The docs subdirectories in the library subdirectories (1ib0001-FF) in the post office contain an array 
of subdirectories for storing documents. 


FDO0-FF directories The FDO-FF subdirectories in the docs subdirectory in the post office store 
documents that are equal to or greater than 2 KB in size. The 0-FF variable represents hexadecimal 
number 0 through FF, so the subdirectories are named FDO through FDFF. The document databases 
(dmxxnn01-FF. db files) contain pointers to documents stored in the subdirectories of the docs 
directory. 


7.2.4 ofmsg directory 


The ofmsg subdirectory in the post office contains as many as 255 databases where messages are 
stored. It serves as centralized storage for all users in the post office. A message must be stored only 
once to be delivered to any number of users in the same post office. 


Historical Note: An earlier version of GroupWise, designed by WordPerfect Corporation (WPCorp), 
was named WP Office. Hence, the of in ofmsg. Some naming conventions were originally preserved 
for backward compatibility. 


msgnnn.db file 


The msgnnn. db files in the ofmsg subdirectory in the post office are the message databases where 
users’ messages smaller than 2 KB are stored. To increase database efficiency, messages, attachments, 
and recipient lists equal to or greater than 2 KB are stored outside the msgnn. db files in an array of 
subdirectories in the of files directory. After the 2 KB limit is reached, only pointers are stored in the 
message databases. 


The nnn variable in the database names is a three-digit number from 0 to 254. A hashing algorithm 
takes each user’s GroupWise file ID (FID) to derive which database the user’s outgoing mail is 
assigned to. The contents of the messages databases are encrypted so the text of message can only be 
read through GroupWise. 


Multiple users are assigned to the same message database. You can use GWCheck to determine 
which database a specific user has been assigned to. See “GroupWise Check” in “Standalone 
Database Maintenance Programs” in the GroupWise 8 Administration Guide. 


ngwdfr.db file 


The ngwdfr .db file in the ofmsg subdirectory in the post office holds deferred messages that users 
have specified for delivery at a later time. When users delay delivery on messages, the messages are 
transferred to the receiving post office and held in the ngwd£r. db file until the delay expires. 


Historical Note: Earlier versions of GroupWise handled deferred messages through the ofpend 
directory in the post office. 


guardbak directory 


The guardbak subdirectory in the ofmsg subdirectory in the post office holds a backup copy of the 
ngwguard. fbk file. 
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7.2.5 


7.2.6 


ofuser directory 


The ofuser subdirectory in the post office contains a separate database (mailbox) for each 
GroupWise user. 


Historical Note: An earlier version of GroupWise, designed by WordPerfect Corporation (WPCorp), 
was named WP Office. Hence, the of in ofuser. Some naming conventions were originally preserved 
for backward compatibility. 


userxxx.db file 


The userxxx. db files in the ofuser subdirectory in the post office are user databases where the 
contents of users” mailboxes are stored, as displayed in the GroupWise client In addition, each user 
database contains: 

+ Some personal GroupWise client program settings 

¢ Personal appointments 

+ Personal groups 

¢ Personal notes 

¢ Rules 
Personal client settings that remain the same regardless of what workstation a user logs in to are 


stored in the user database. Personal client settings that are customized for a particular workstation 
are stored in the Windows registry. 


The xxx variable in the database names is each user’s GroupWise file ID (FID). 


puxxxxx.db file 


The puxxxxx. db files in the ofuser subdirectory in the post office are databases for replicated items 
such as shared folders. These databases prevent conflicts between user names of shared items from 
users in other post offices and user names in the local post office. 


index directory 


The index subdirectory in the ofuser subdirectory in the post office contains the QuickFinder index 
for users’ messages stored in the post office. 


offiles directory 


The of files subdirectory in the post office contains subdirectories for messages, attachments, and 
recipient lists that are equal to or greater than 2 KB in size. These larger messages, attachments, and 
recipient lists are stored outside the actual message databases in the ofmsg directory to increase 
database efficiency. 


Historical Note: An earlier version of GroupWise, designed by WordPerfect Corporation (WPCorp), 
was named WP Office. Hence, the of in of files. Some naming conventions were originally 
preserved for backward compatibility. 
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fd0-f6 directories 


The £d0-£6 subdirectories in the of files subdirectory in the post office store messages, 
attachments, and recipient lists that are equal to or greater than 2 KB in size. The nn variable 
represents hexadecimal number 0 through f6, so the subdirectories are named fdo through fd£6. The 
message databases (msgnnn. db files) contain pointers to messages, attachments, and recipient lists 
stored in the subdirectories of offiles. 


7.2.7  Oofviews directory 


The ofviews subdirectory in the post office contains subdirectories for GroupWise client platforms. 
Within the platform-specific subdirectories (for example, win) are view (* .vew) files that create the 
various views displayed in the GroupWise client. 


The gwviewxx. ini and ofviewxx. ini files configure the standard views on the menus where users 
select views. The gwviewxx. ini file configures GroupWise 8, 7, 6.x, and 5.5 standard views. The 
ofviewxx.ini file configures standard views from earlier versions of GroupWise. 


Historical Note: An earlier version of GroupWise, designed by WordPerfect Corporation (WPCorp), 
was named WP Office. Hence, the of in ofviews. Some naming conventions were originally 
preserved for backward compatibility. 


7.2.8  ofwork directory 


The ofwork subdirectory in the post office is a working directory for requests from the GroupWise 
client in Remote mode. 


Historical Note: An earlier version of GroupWise, designed by WordPerfect Corporation (WPCorp), 
was named WP Office. Hence, the of in ofwork. Some naming conventions were originally preserved 
for backward compatibility. 


7.2.9  ofdirect directory 


The ofdirect subdirectory in the working directory (ofwork) in the post office is used by the 
GroupWise client in Remote mode for direct connections when the network is available. 


Historical Note: An earlier version of GroupWise, designed by WordPerfect Corporation (WPCorp), 
was named WP Office. Hence, the of in ofdirect. Some naming conventions were originally 
preserved for backward compatibility. 


7.2.10  oftemp directory 


The oftemp subdirectory in the post office holds various temporary files such as the MIME files 
created during access by IMAP e-mail clients. 


gwdca directory 


The gwdca subdirectory in the post office holds subdirectories used by the Document Conversion 
Agent as it converts documents to HTML for indexing by the QuickFinder thread. For more 
information, see “Configuring the Document Conversion Agent for Indexing Specific Document 
Types” in “Post Office Agent” in the GroupWise 8 Administration Guide. 
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7.2.11 


in directory 


The POA decrypts attachments and delivers them into the in directory for processing by the 
Document Conversion Agent. 


out directory 


The Document Conversion Agent converts documents placed in the in directory into HTML, then 
places them in the out directory for indexing by the POA. After the POA indexes each HTML file, it 
deletes the HTML version. 


problem directory 


If the Document Conversion Agent cannot convert a file, and if Quarantine Files That Fail during 
Conversion is selected on the POA object in ConsoleOne, the Document Conversion Agent places the 
document in the problem subdirectory. Documents in the problem directory are not encrypted. 


log directory 


When it starts, the Document Conversion Agent writes its current configuration settings into its log 
file in the 1og directory. If a document fails conversion, error information is written to the log file. 


wpcsout directory 


The wpcsout subdirectory in the post office is the MTA output queue in each post office. It contains 
subdirectories which function as input queues for the other agents to which the MTA delivers 
messages. 


Historical Note: WP Office, the predecessor of GroupWise, was originally designed by WordPerfect 
Corporation (WPCorp). The Message Transfer Agent (MTA) was originally named the Connection 
Server (CS). Hence, the directory name wpcsout for the MTA output queue. Some naming 
conventions were originally preserved for backward compatibility. 


ofs directory 


The ofs subdirectory of the MTA output queue (wpcsout) in the post office is the POA input queue 
in each post office. It contains eight priority subdirectories to handle different types of message 
traffic. 


+ Incoming user messages are queued by priority for delivery to recipients’ mailboxes in the local 
post office. 


+ Incoming status messages are queued by priority for delivery to senders’ mailboxes in the local 
post office. 


¢ Incoming Busy Search requests are queued for the POA to check users’ schedules in the local 
post office. 


The POA scans these priority subdirectories regularly. When a new message arrives, the POA 
processes the messages and performs the required actions. 
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0 directory 


The priority 0 subdirectory of the POA input queue (w9csoutlofs) in the post office is for service 
requests that demand an immediate response from the POA. 


For example, the MTA places Busy Search requests here so the POA can check recipients' schedules 
and quickly return the schedule information to the sender. 


1 directory 


The priority 1 subdirectory of the POA input queue (wpcsout \ofs) in the post office is for service 
requests of the next highest priority. 


For example, the MTA places requests from remote GroupWise users for items in their master 
mailboxes here. The POA then processes the messages and returns the requested items. 


2 directory 


The priority 2 subdirectory of the POA input queue (wpcsout \ofs) in the post office is for high 
priority user messages being delivered to recipients in the local post office. 


For example, the MTA places high priority user messages here. The POA then updates the message 
databases and recipients’ mailboxes. 


3 directory 


The priority 3 subdirectory of the POA input queue (wpcsout \ofs) in the post office is for high 
priority status messages coming back to senders in the local post office. 


For example, the MTA places status responses to high priority user messages here. The POA then 
updates the message databases and senders’ mailboxes with current message status. 


4 directory 


The priority 4 subdirectory of the POA input queue (wpcsout \ofs) in the post office is for normal 
priority user messages being delivered to recipients in the local post office. 


For example, the MTA places normal priority user messages here. The POA then updates the 
message databases and recipients’ mailboxes. Most messages in your GroupWise system pass 
through the priority 4 subdirectory. 

5 directory 


The priority 5 subdirectory of the POA input queue (wpcsout \ofs) in the post office is for normal 
priority status messages coming back to senders in the local post office. 


For example, the MTA places status responses to normal priority user messages here. The POA then 
updates the message databases and senders’ mailboxes with current message status. 


6 directory 


The priority 6 subdirectory of the POA input queue (wocsout \ofs) in the post office is for low 
priority user messages being delivered to recipients in the local post office. 


For example, the MTA places low priority messages here. The POA then updates the message 
databases and recipients’ mailboxes. 
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7 directory 


The priority 7 subdirectory of the POA input queue (w9csoutlofs) in the post office is for low 
priority status messages coming back to senders in the local post office. 


For example, the MTA places status responses to low priority user messages here. The POA then 
updates the message databases and senders' mailboxes with current message status. 


defer directory 


The defer subdirectory of the POA input queue (wpcsout \ofs) in the post office is used to 
temporarily store deferred messages when the ngwdfr . db database is locked. This might occur if 
backup software has locked the ngwd£r.db database. After the ngwd£r. db database is available 
again, deferred messages are written to the ngwd£r.db database as usual. 


mmddpoa.nnn files 


The mmddpoa. nnn files are POA log files. The POA creates log files to inform you of its processing 
and any problems it encounters. By default, these log files are created in the wpcsout \ofs directory. 
You can change the location if needed. See “Using POA Log Files” in “Post Office Agent” in the 
GroupWise 8 Administration Guide guide. 


The first two digits of the filename represent the month, the next two digits represent the day of the 
month, and the next three characters indicate what program created the log. The three-digit 
extension is a sequence number for multiple log files created on the same day. For example, 
0518poa.002 is the second POA log file created on May 18. 


wprof50.db file 


The wpro£50. db file in the wocsout \ofs directory is the downloadable system Address Book for 
Remote client users. By default, it is automatically re-created once a day to keep it up to date. See 
“Performing Nightly User Upkeep” in “Post Office Agent” in the GroupWise 8 Administration Guide 
guide. 


ads directory 


The ads subdirectory of the MTA output queue (wpcsout) in the post office is the input queue for the 
POA admin thread in each post office. It contains priority subdirectories where administrative 
messages are queued for processing. 


Historical Note: The POA admin thread was previously part of a separate agent, the Administration 
Agent (ADA), which was originally named the Administration Server (ADS). Hence, the directory 
name ads. Some naming conventions were originally preserved for backward compatibility. 


0 directory 


The priority 0 subdirectory of the POA admin thread input queue (wpcsout \ads) in the post office is 
for service requests that demand an immediate response from the POA admin thread. 


1 directory 


The priority 1 subdirectory of the POA admin thread input queue (wpcsout \ads) in the post office is 
for service requests of the next highest priority. 


For example, a directory synchronization request that could not be performed when the POA admin 
thread received it in its domain input queue would be placed here in the post office for later 
processing. 
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2 directory 


The priority 2 subdirectory of the POA admin thread input queue (wpcsout \ads) in the post office is 
for high priority administrative messages. 


For example, a database update request that could not be performed when the POA admin thread 
received it in its domain input queue would be placed here in the post office for later processing. 


chk directory 


The chk subdirectory of the MTA output queue (wpcsout) in the post office is the working directory 
where the multithreaded GWCheck process keeps temporary files during database maintenance and 
where it tracks the activities of its various threads. The defer subdirectory is used when the 
ngwcheck . db database is locked, for example, by a backup program. 


problem directory 


The problem subdirectory of the MTA output queue (wpcsout) in the post office is a holding area for 
damaged message files. Problem files are marked with an extension indicating which GroupWise 
agent placed each file in the problem directory. 


You should check this directory periodically for problem files, resolve the problem, then place the 
files back into the appropriate queue for continued processing. For assistance, see “Message Is 
Dropped in the problem Directory in the Post Office” in “Strategies for Message Delivery Problems” 
in the GroupWise 8 Troubleshooting 2: Solutions to Common Problems. 


7.2.12 — wphost.db file 


The wphost . db file in the post office is the post office database. It contains all administrative 
information for the post office. It also contains the Address Book for the post office. 


In GroupWise 8, 7, 6.x, and 5.x post offices, the data dictionary for the wphost . db file is the gwpo.dc 
file. In GroupWise 4.x post offices, the data dictionary is the wphost . dc file. As a result, wphost . db 
files have different structures (schemas) depending on whether they were created for GroupWise 8/7/ 
6.x/5.x or 4.x post offices. 


Historical Note: WP Office, the predecessor of GroupWise, was originally designed by WordPerfect 
Corporation (WPCorp). Post offices were originally called hosts. Hence, the name wphost . db. Some 
naming conventions were originally preserved for backward compatibility. 


7.2.13  gwpo.dc file 


The gwpo. dc file in the post office is the data dictionary for creating and rebuilding GroupWise 8, 7, 
6.x, and 5.x post office databases (wphost . db files). 


If the gwpo.dc file is missing from a post office and its domain, you cannot create or rebuild 
GroupWise 8, 7/6.x/5.x post offices in that domain. The original gwpo . dc file is located in the domain 
directory of the software distribution directory or on the GroupWise 8 DVD or GroupWise 8 
downloaded software image. 


7.2.14  ngwguard.db file 


The ngwguard. db file in the post office is the guardian database. See “Information Stored in the Post 
Office” in “Post Office Agent” in the GroupWise 8 Administration Guide. 


76 GroupWise 8 Troubleshooting 3: Message Flow and Directory Structure 


7.2.15 


7.2.16 


7.2.17 


7.2.18 


7.3 


ngwguard.dc file 


The ngwguard. dc file in the post office is the data dictionary for building the following databases in 
the post office: 


+ ngwguard.db (guardian database) 
dmxxnn01-ff.db (document management databases) 
msgnnn.db (message databases) 
userxxx.db (user databases) 


puxxxxx. db (databases for replicated items like shared folders) 


ngwguard.fbk file 


The ngwguard. fbk file in the post office is a “fall back” copy of the ngwguard. db file. If the 
ngwguard. db file becomes damaged, the ngwguard. fbk file, along with the ngsguard.rf1 file, can 
be used to rebuild a valid, current ngwguard. db file. The ngwguard. fbk file is so important that an 
additional copy of it is kept in the ofmsg\guardbak subdirectory in case the copy in the post office 
directory is inadvertently deleted. See “Guardian Databases” in “Databases” in the GroupWise 8 
Administration Guide. 


ngwguard.rfl file 
The ngwguard.rf1 file in the post office is a roll-forward transaction log of every database 


transaction that has taken place since the last copy of the ngwguard. fbk file was created. See 
“Guardian Databases” in “Databases” in the GroupWise 8 Administration Guide. 


ngwcheck.db 
The ngwcheck. db file in the post office is the database that controls GWCheck’s multithreaded 


processing. It contains job and task records that are used to synchronize and summarize GWCheck 
requests as they progress. 


MTA Local Queue Directory 


HH] mslocal MTA local working directory 
_] mmddxxx. nn MTA log files on NetWare and Windows 
E msglog Message logging directory 
_] mmddmsg. nn Message logging files 
HA] gwinprog MTA "in progress” queue directory 
0-7 Priority subdirectories 
E mshold MTA holding directory 
E domainms Processing directory for MTA 
BN) 0-7 Priority subdirectories 
_] mtaname Location identifier 
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HH] postx 
E 0-7 
_] mtaname 
MY gatewayx 
BN 0-7 
_] mtaname 
HN] domainx 
E 0-7 


_] mtaname 
E gwvsscan 


HN] mtaconv 


Holding directories for post offices 
Priority subdirectories 
Location identifier 


Holding directories for gateways 
Priority subdirectories 
Location identifier 


Holding directories for other domains 
Priority subdirectories 
Location identifier 


Working directory for third-party virus scanning programs 


Work area for 5.x to 4.x conversion 


7.3.1  mslocal directory 


The mslocal directory is the MTA local working directory. The /work startup switch of the MTA 
specifies the location of the mslocal directory. It must be located on the hard disk of the server where 
the MTA runs so itis always accessible. Adequate disk space must be available to hold messages 
going to destinations that are temporarily closed. 


Initially, the mslocal directory is created as a subdirectory of the domain directory. If the MTA runs 
on a different server from where the domain directory structure is located, typical locations for the 
mslocal directory include: 


* sys: system on a NetWare server 


+ c:1ona Windows server 


To move the mslocal directory to the server where the MTA is running, stop the MTA, the copy the 
mslocal directory, along with all of its subdirectories, to the new location. Then restart the MTA and 
specify the new location using the /work startup switch. 


Historical Note: In earlier versions of GroupWise, the Message Transfer Agent (MTA) was called the 
Message Server (MS). Hence, the ms in ms1ocal. Some naming conventions were originally preserved 
for backward compatibility. 


mmddxxx.nnn files 


The mmddxxx. nnn file are MTA log files. The MTA creates log files to inform you of its processing and 
any problems it encounters. By default, these log files are created in the mslocal directory. You can 
change the location if needed. See “Using MTA Log Files” in “Message Transfer Agent” in the 
GroupWise 8 Administration Guide. 


The first two digits of the filename represent the month; the next two digits represent the day of the 
month, the next three characters indicate what program created the log. The three-digit extension is a 
sequence number for multiple log files created on the same day. For example, 0518mta. 002 is the 
second MTA log file created on May 18. 


On Linux, the MTA log files are stored in the /var/log/novell/groupwise/domain.mta directory 


Historical Note: In earlier versions of GroupWise, the Message Transfer Agent (MTA) was called the 
Message Server (MS). Hence, the ms indicator representing the MTA. Some naming conventions were 
originally preserved for backward compatibility. 
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7.3.2 


7.3.3 


7.3.4 


7.3.5 


msglog directory 


The msglog subdirectory contains message logging files. It is created when you turn on message 
logging. The MTA receiver threads log messages as they arrive so the MTA worker threads can 
process messages without having to scan the MTA input queues to look for work. 


The resources used for message logging are configurable. See “Optimizing the Routing Queue” in 
“Optimizing the MTA” in the GroupWise 8 Administration Guide. 


More detailed message logging by the MTA is also available, but is turned off by default. See 
“Enabling MTA Message Logging” in “Configuring the MTA” in the GroupWise 8 Administration 
Guide. 


mmddmsg.nnn files 


The mmddmsg. nnn files in the message logging subdirectory (msglog) in the MTA local directory are 
used by the MTA to track messages in its “in progress” queue. 


The first two digits of the filename represent the month; the next two digits represent the day of the 
month. The three-digit extension is a sequence number for multiple files created on the same day. For 
example, 0518msg.002 is the second message logging file created on May 18. 


gwinprog directory 


The gwinprog subdirectory is the MTA “in progress” queue. It contains eight priority subdirectories 
parallel to those found in wpcsin. All messages for recipients in the domain pass through gwinprog, 
no matter whether they arrived by way of TCP/IP or by way of message files deposited into the MTA 
input queue by a POA or another MTA. 


The resources used to process the “in progress” queue are configurable. See “Optimizing the Routing 
Queue” in “Optimizing the MTA” in the GroupWise 8 Administration Guide. 


mshold directory 


The mshold subdirectory is a holding queue for messages addressed to domains, post offices, or 
gateways that are currently closed. 


A location might be closed because its server is down or because the MTA is unable to communicate 
with it for any other reason. When a closed location is again open, the MTA moves messages from the 
holding queue back into the normal message flow. 


Historical Note: In earlier versions of GroupWise, the Message Transfer Agent (MTA) was called the 
Message Server (MS). Hence, the ms in mshold. Some naming conventions were originally preserved 
for backward compatibility. 


domainms directory 


The domainms subdirectory in the holding directory (mshold) is used for internal processing by the 
MTA. It does not contain any files a GroupWise administrator needs to access. 


Historical Note: In earlier versions of GroupWise, the Message Transfer Agent (MTA) was called the 
Message Server (MS). Hence, the ms in domainms. Some naming conventions were originally 
preserved for backward compatibility. 
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7.3.6 


7.3.1 


7.3.8 


7.3.9 


7.3.10 


postx directories 


The postx subdirectories in the holding directory (mshold) represent post offices in the domain. If a 
post office is closed, the MTA routes messages for that post office into its holding queue in mshold. 
When the post office is open, the MTA moves the messages from the holding queue back into the 
regular message flow. For more information, see “Message Delivery to a Different Post Office” on 
page 19. 


The name of the holding queue for each post office consists of the first three characters of the post 
office name, followed by four hashed characters to ensure uniqueness. 


gatewayx directories 


The gat ewayx subdirectories in the holding directory (mshold) represent gateways in the domain. If a 
gateway is closed, the MTA routes messages for that gateway into its holding queue in mshold. When 
the gateway is open, the MTA moves the messages from the holding queue back into the regular 
message flow through the gateway. 


The name of the holding queue for each gateway consists of the first three characters of the gateway 
name, followed by four hashed characters to ensure uniqueness. 


domainx directories 


The domainx subdirectories in the holding directory (mshold) represent domains to which the 
current domain has a direct link. If a domain is closed, the MTA routes messages for that domain into 
its holding queue in mshold. When the domain is open, the MTA moves the messages from the 
holding queue back into the regular message flow. For more information, see “Message Delivery to a 
Different Domain” on page 25. 


The name of the holding queue for each domain consists of the first three characters of the domain 
name, followed by four hashed characters to ensure uniqueness. 


0-7 directories 


The priority 0-7 subdirectories in each holding queue in the mshold subdirectory correspond to the 
priority 0-7 subdirectories located in each domain, post office, or gateway. See the following 
directory structures for more information about its priority 0-7 subdirectories: 


¢ Section 7.1, “Domain Directory,” on page 57 


+ Section 7.2, “Post Office Directory,” on page 64 


mtaname files 


The mtaname files in the closed location holding queues provide the name associated with the 
domain, post office, or gateway holding queue. They can help you check links between MTAs in 
ConsoleOne without going to the MTA agent console to determine the location name. To associate a 
location name with its holding queue directory from the MTA agent console, click Configuration 
Status > select the location > click Details. 
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7.3.11 


7.3.12 


1.4 


7.4.1 


gwvsscan directory 


The gwvsscan subdirectory is the working directory where third-party virus scanning programs that 
snap in to the MTA can perform their processing. 


mtaconv directory 
The mtaconv subdirectory is the working directory where the MTA converts GroupWise 8, 7, 6.x, and 


5.x messages to 4.x format for transfer to a GroupWise 4.x system. After the conversion is finished, 
this directory should be empty. 


WebAccess Agent Queue Directory 


The following directories and files are found under the \domain\wpgate\ structure for the 
WebAccess Agent after the software has been installed and the WebAccess Agent has processed 
messages. 


E domain\wpgate\webac80a GroupWise WebAccess Agent home directory 


EH] 000 ¿Pre WebAccess Agent log file processing directory 
A] gwwork Hold directory for temporary files used during processing 
_] nmddweb. nnn WebAccess Agent log files 
E wpcsin MTA input queue directory 
BN 0-7 Message priority subdirectories 
E wocsout MTA output queue 
E webxxxx System-defined directory for the WebAccess Agent 
BN 0-7 Message priority subdirectories 
@ problem Hold directory for damaged outbound messages 
E gwhold Hold directory for delayed delivery messages 
dal gwprob Hold directory for damaged inbound messages 
HH] template Directory for templates for viewing documents 
_] commgr.cfg Communications Manager configuration file 
_] comint .cfg Communications initialization configuration file 
_] mimetype.cfg MIME encoding configuration file for various file types 
_] gwac.db Access control database 
_] gwac.de Database dictionary file used to create the gwac.db file 


domain\wpgate\webac80a directory 


The domain\wpgate\ webac80a directory is the WebAccess Agent home directory where WebAccess 
Agent configuration files and queue directories are located. The name is established when you install 
the WebAccess Agent. The default is wogate\webac80a in the domain directory. You can change the 

location using the /home startup switch in the WebAccess Agent configuration file (webac80a.waa in 
the WebAccess Agent installation directory). 
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1.4.2 


7.4.3 


7.4.4 


7.4.5 


7.4.6 


7.4.7 


7.4.8 


000.prc directory 


The NetWare and Windows WebAccess Agents use the 000 . prc directory to store log files. 


On Linux, the 000 . prc directory is located under /var/log. 


mmddlog.nnn file 


The mmddlog.nnn files hold error and status messages about the functioning of the WebAccess 
Agent. The WebAccess Agent creates a log file each day with a unique name, where mm is the month, 
dd is the day, and nnn is a sequential number indicating the sequence of log files in a single day. For 
more information about log files, see “Controlling WebAccess Agent Logging” in “WebAccess” in the 
GroupWise 8 Administration Guide. 


wpcsin directory 


No longer used. The WebAccess Agent and the MTA communicate by way of TCP/IP and do not 
need queue directories. 


wpcsout directory 


No longer used. 


gwhold directory 


No longer used. 


gwprob directory 


No longer used. 


template directory 


The template directory holds the HTML templates used for viewing documents in HTML format. 


commgr.cfg file 


The commgr . cfg file in the WebAccess Agent queue directory contains information for 
communication between the WebAccess Agent and the WebAccess Application, including the IP 
address and port where the WebAccess Agent is running, the number of threads that are running, 
and the encryption key for the WebAccess Agent. This communications information is gathered 
during installation. For more information, see “Configuring the GroupWise Service Provider” in 
“WebAccess” in the GroupWise 8 Administration Guide. 


As part of the installation process, the commgr . cfg file is automatically copied to the Web server 
installation (sys : \Novel1\GroupWise\WebAccess on NetWare, /var/opt /novell/groupwise/ 
webaccess on Linux, and c:\Novell\GroupWise\WebAccess on Windows). The copies are 
synchronized automatically by the WebAccess Application. The commgr . cfg file is also copied to the 
webpublisher subdirectory on the Web server. 
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7.4.9 


7.4.10 


7.4.11 


7.4.12 


1.95 


comint.cfg file 
The comint . cfg file in the WebAccess Agent queue directory is read by the WebAccess Agent on 


startup. It contains the same communications information as the commgr . cfg file and is synchronized 
with it automatically. 


mimetype.cfg file 
The mimetype. cfg file enables you to customize MIME content-type mappings for various 
attachment types. The WebAccess Agent handles this just as the Internet Agent does. For more 


information, see “Customizing MIME Content-Type Mappings” in “Internet Agent” in the GroupWise 
8 Administration Guide 


gwac.db file 


The gwac. db file is the access control database that stores information about the classes of service you 
have created. For more information, see “Maintaining the Access Database” in “WebAccess” in the 
GroupWise 8 Administration Guide. 


gwac.dc file 


The gwac . dc file is the data dictionary file from which the gwac . db is created. 


Internet Agent Queue Directory 


The following directories and files are found under the \domain\wpgate\ structure for the Internet 
Agent after the software has been installed and the Internet Agent has processed messages. 


YA] domain\wpgate\gwia GroupWise Internet Agent home directory 


EN 000 ¿pre Internet Agent message processing directory 
E cma Not currently used 
3] gwwork Hold directory for temporary files used during processing 
_] mmddlog.nnn Log files 
Jl acct Accounting file 
LÌ set Settings file for screen colors, log levels, and so on 
LJ stat Statistics file for Internet Agent operation 
_] proc Process lock file indicating that the Internet Agent is running 
_] pulse.tmp Temporary file to verify Internet Agent operation 
B wpcsin MTA input queue directory 
Š 0-7 Message priority subdirectories 
el wpcsout MTA output queue 
EN] gwixxxx System-defined directory 
BN 0-7 Message priority subdirectories 
al problem Hold directory for damaged outbound messages 
E gwhold Message hold directory 
Ü gfiles Delayed delivery hold directory 
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E] gwprob 
E] gwchars 
$ save 


_] gwia.cfg 

Lj route.ctg 

O gwauth.cfg 
_] mimetype.cfg 
L exepath.cfg 
_] £rgnames.cfg 
O xspam.cfg 


Jj gwac.db 
k gwac.dc 


O preamble.txt 
_] preamble.all 


_] blocked. txt 
Jj statusxx.xml 


3 


E] gwia 


HN] send 
HN] receive 
HN] result 


Es] defer 
Bl work 


HH] dsnhold 


Hold directory for damaged inbound messages 
Directory for character conversion tables 
Directory for old configuration files from reinstalls or upgrades 


Internet Agent configuration file for startup switches 
Route configuration file to customize routing 

Host authentication configuration file 

MIME encoding configuration file for various file types 
Configuration file pointing ConsoleOne to the gwia.cfg file 
Foreign domain name configuration file 

Anti-spam configuration file 


Access control database 
Database dictionary file used to create the access control database 


Message for recipients who lack a MIME-compliant mail reader 
Preamble message in various languages 


List of blocked Internet sites 
File for customizing status messages 


SMTP service (daemon) home directory 


Outbound hold directory for converting messages into Internet format 
Incoming hold directory for converting messages into GroupWise format 
Send and result files to confirm transmission 


Hold directory for re-queued and deferred messages 
Schedule files for SMTP service operations on deferred messages 


Delivery Status Notification (DSN) hold directory 


7.5.1 domainwpgatelgwia directory 


The domain\wpgate\ gwia directory is the GroupWise Internet Agent home directory where Internet 
Agent configuration files and queue directories are located. The name is established when you install 
the Internet Agent. The default is wogate\gwia in the domain directory. You can change the location 
using the /home startup switch in the Internet Agent configuration file (gwia.cfg). 


000.prc directory 


The Internet Agent uses the 000.pre directory to process messages. 


gwwork directory 


The gwwork directory stores temporary files created by the Internet Agent as it converts and builds 
messages for transfer across the Internet. 
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mmddlog.nnn file 


The mmddlog. nnn files hold error and status messages about the functioning of the Internet Agent. 
The Internet Agent creates a log file each day with a unique name, where mm is the month, dd is the 
day, and nnn is a sequential number indicating the sequence of log files in a single day. For more 
information log files, see “Using Internet Agent Log Files” in “Internet Agent” in the GroupWise 8 
Administration Guide. 


acct file 


The acct file contains information about the messages the Internet Agent sends each day. It is e- 
mailed to the accounts each day at midnight. For more information about the accounting files, see 
“Tracking Internet Traffic with Accounting Data” in “Internet Agent” in the GroupWise 8 
Administration Guide. 


set file 


The set file stores Internet Agent console settings such as color, log settings, and so on. For more 
information, see “Using the Internet Agent Server Console”. 


stat file 


The stat file stores statistics about the Internet Agent's functioning. For information about the 
statistics provided by the Internet Agent, see “Statistics” in “Internet Agent” in the GroupWise 8 
Administration Guide. 


proc file 


The proc file is the lock file for the Internet Agent process. The proc file is opened and locked when 
the Internet Agent starts. This prevents multiple Internet Agents from being started for the same 
domain. 


pulse.tmp file 


The pulse. tmp file is re-created by the Internet Agent every time it completes a cycle (after an idle 
loop). If you are not at the Internet Agent console but need to know if the Internet Agent is running, 
you can delete the pulse. tmp file. If the Internet Agent is running, it re-creates the file. 


wpcsin directory 


For a mapped/UNC link, the Internet Agent places inbound messages in one of the wocsin priority 
subdirectories (0-7). Most messages go in the 4 directory, although some administrative and status 
messages might go in other directories. The Message Transfer Agent retrieves the messages and 
delivers them to the proper destinations. 


For a TCP/IP link, the Internet Agent and the MTA communicate by way of TCP/IP rather than by 
transferring message files. For a comparison, see Chapter 4, “Message Delivery to and from the 
Internet,” on page 33. 
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wpcsout directory 


For a mapped/UNC link, the wpcsout directory is the MTA output queue as well as being the Internet 
Agent input queue. 


For a TCP/IP link, the Internet Agent and the MTA communicate by way of TCP/IP rather than by 
transferring message files. For a comparison, see Chapter 4, “Message Delivery to and from the 
Internet,” on page 33. 


gwixxxx directory 


The gwixxxx directory is a system-defined directory, where gwi represents the first three letters of the 
Internet Agent object name as defined during installation and displayed in ConsoleOne, and xxxx is a 
randomly-generated string. Here, the Message Transfer Agent places outbound messages in the 
appropriate 0-7 priority subdirectory for the Internet Agent to retrieve and process. 


problem directory 
The problem directory holds messages that the MTA cannot process. 


You should check this directory periodically for problem files, resolve the problem, then place the 
files back into the appropriate queue for continued processing. For assistance, see “Message Is 
Dropped in the problem Directory in the Domain” in “Strategies for Message Delivery Problems” in 
the GroupWise 8 Troubleshooting 2: Solutions to Common Problems. 


gwhold directory 


The gwhold directory holds messages that are scheduled for delayed delivery. 


qfiles directory 


The qfiles directory holds messages that cannot be sent during the current Send/Receive cycle. The 
messages are queued to this directory until the next cycle. 


The delayed delivery messages waiting in the qfiles directory remain in encrypted format until the 
Internet Agent transfers them to the send directory for processing by the SMTP service. 


gwprob directory 
The Internet Agent uses the gwprob directory for messages it cannot process. These are usually 


messages that have been damaged during transmission or that contain incorrectly formed MIME 
data. 


These messages cannot be recovered. You can delete them to conserve disk space. 


gwchars directory 


This directory contains conversion tables that the Internet Agent uses to convert message 
attachments between character sets. 


save directory 


If you reinstall or upgrade the Internet Agent, your old configuration files are copied to the save 
directory as a backup. If you reinstall or upgrade repeatedly, the files are overwritten each time. 
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gwia.cfg file 


The gwia.cfg file is the Internet Agent configuration file that contains startup switches. Some 
switches are set during installation. You can set others as needed. For more information, see “Using 
Internet Agent Startup Switches” in “Internet Agent” in the GroupWise 8 Administration Guide. 


NetWare: The NetWare Internet Agent uses the gwia.cfg file created in sys: | system during 
installation. The gwia.cfg file under the domain is just a boilerplate file with no switches 
set during installation. 


Linux: The Linux Internet Agent uses the gwia.c£g file created in /opt /novell/ 
groupwise/agents/share during installation. The gwia.cfg file under the domain is 
just a boilerplate file with no switches set during installation. 


Windows: Only the Windows Internet Agent actually uses the gwia.cfg file under the domain. 


route.cfg file 


The route. cfg file enables you to customize routing for specific hosts. For more information, see 
“Using a Route Configuration File” in “Internet Agent” in the GroupWise 8 Administration Guide. 


gwauth.cfg file 


The gwauth. c£g file enables the Internet Agent to log in to SMTP hosts that require authentication. 
For more information, see “SMTP Host Authentication” in “Internet Agent” in the GroupWise 8 
Administration Guide. 


mimetype.cfg file 


The mimetype. cfg file enables you to customize MIME content-type mappings for various 
attachment types. For more information, see “Customizing MIME Content-Type Mappings” in 
“Internet Agent” in the GroupWise 8 Administration Guide 


exepath.cfg file 


The exepath. cfg file is used by ConsoleOne to locate the gwia.cfg file. This enables ConsoleOne to 
write any configuration setting changes to the gwia. cfg file or update Novell eDirectory with any 
changes from the file. The file must contain the path to the gwia.cfg file in the sys: system 
directory on NetWare, the /opt /novell/groupwise/agents/share directory on Linux, or the 
domain\wpgate\gwia directory on Windows. 


frgnames.cfg file 


The £rgnames . cfg file lets you list more Internet domain names than can fit in the Foreign ID field on 
the Identification page of the Internet Agent object in ConsoleOne. For more information, see 
“Configuring How the Internet Agent Handles E-Mail Addresses” in “Internet Agent” in the 
GroupWise 8 Administration Guide. 
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88 


7.5.2 


xspam.cfg file 


The xspam. cfg file lists “X” header fields that your anti-spam service writes to the MIME header, 
along with the values that flag the message as spam. The Internet Agent examines the MIME header 
for any field listed in the xspam. cfg file. When a match occurs, the message is marked for handling 
by the GroupWise client Junk Mail Handling feature. For more information, see “Customized Spam 
Identification” in “Internet Agent” in the GroupWise 8 Administration Guide. 


gwac.db file 


The gwac. db file is the access control database that stores information about the classes of service you 
have created. For more information, see “Maintaining the Access Control Database” in “Internet 
Agent” in the GroupWise 8 Administration Guide. 


gwac.dc file 


The gwac . de file is the data dictionary file from which the gwac . db is created. 


preamble.txt file 


The preamble.txt file is an ASCII text file that is automatically included with any MIME multipart 
message and is displayed when the message recipient lacks a MIME-compliant mail reader. For more 
information, see “Customizing MIME Preamble Text” in “Internet Agent” in the GroupWise 8 
Administration Guide. 


preamble.all file 


The preamble.al1 file contains the preamble text in multiple languages. For more information, see 
“Customizing MIME Preamble Text” in “Internet Agent” in the GroupWise 8 Administration Guide. 


blocked.txt file 


The blocked. txt file contains a list of Internet sites that you have added to the Prevent Messages 
From list for your default class of service in ConsoleOne. For more information, see “Controlling 
User Access to the Internet” in “Internet Agent” in the GroupWise 8 Administration Guide. 


statusxx.xml file 


The statusxx.xml file enables you to customize the messages that users receive regarding message 
delivery status. For more information, see “Customizing Delivery Status Notifications” in “Internet 
Agent” in the GroupWise 8 Administration Guide. 


gwia directory 


The gwia directory is the SMTP service (daemon) home directory where messages are converted 
between GroupWise format and Internet format. On NetWare and Linux, the default location is 
wpgate/gwia, the same as the Internet Agent home directory. On Windows, the default location is the 
Internet Agent installation directory. You can change the location using the /dhome startup switch in 
the Internet Agent configuration file (gwia.cfg). 
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7.6 


send directory 


The Internet Agent SMTP service places outbound messages in the send directory after they have 
been converted out of GroupWise format into SMTP format. The SMTP service polls the send 
directory and sends any messages to the destination SMTP host. 


receive directory 


The Internet Agent SMTP service places inbound messages in the receive directory, converts them 
into GroupWise format, and then passes them to the Message Transfer Agent by placing them in the 
wpcsin directory. 


result directory 


When the Internet Agent SMTP service processes the message, it builds a file, r* . *, in the result 
directory that contains several lines of comments and SMTP reply codes, which might indicate 
possible errors or confirm correct transmission. After the Internet Agent SMTP service has completed 
the transmission with the destination host, it moves another file, s+ . * from the send directory to the 
result directory. The filenames for both files are identical, except for the first letter, which is either 
“s” or “r”. The s*.* file is the converted message file. The SMTP service looks at the “s” and “r” files 
in the result directory and compares the conversation. If the r* . * file contains the correct (250 OK) 
SMTP reply codes, the SMTP service deletes the file and sends a transferred status message to the 
user's Sent Items folder in the GroupWise client. 


defer directory 


The defer directory holds messages that are deferred and re-queued according to the Retry 
Schedule. If the Internet Agent SMTP service receives a temporary error, such as Host Down, it places 
the message in the defer directory for a specified time, then transfers the file to the send directory for 
another attempt at sending to the Internet. For more information, see “Configuring Basic SMTP/ 
MIME Settings” in “Internet Agent” in the GroupWise 8 Administration Guide. 


dsnhold directory 


The dsnhold directory stores header information for inbound messages that request delivery status 
notifications. For more information, see “Using Extended SMTP (ESMTP) Options” in “Internet 
Agent” in the GroupWise 8 Administration Guide. 


Caching Mailbox Directory 


EA] c: Documents and GroupWise Caching mailbox on Windows XP 
Settings\username\Local 
Settings\Application 
DatalNovelllGroupWiselgwxxx 
XXX 


Mc: \User\username\AppData\L GroupWise Caching mailbox on Windows Vista 
ocal\Novell\GroupWise\gwxxx 
XXX 


HH] /nome /username/gwcache / GroupWise Caching mailbox on Linux 
QGWXXXXXX 
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el /Users/username/gwcache/ 


QGWXXXXXX 


a rofdata 


GroupWise Caching mailbox on Mac 


Caching mailbox database directory 


Jj msg.db Cached message database 

_] user. db Cached user database 

_] wprof .db Cached Address Book 

J wprof .dc Data dictionary for cached Address Book 
_] ngwguard. db Guardian database 

_] ngwguard. dc Data dictionary for guardian database 

_] ngwguard.rfl Guardian database roll forward log 

_] ngwguard. fbk Guardian database “fall back” file 


LJ puxxxxx.db 


L ngwcheck. 


db 


J gwcheckn. log 


È gwdms 


_] dmsh. db 


_] dmxxnn01-FF.db 


Database for shared folders 


GroupWise Check database 
Log file created by the Repair Mailbox feature 


Document Management Services directory 
Shared DMS database 
Document databases 


E docs Subdirectory for documents in the Caching mailbox 
E index QuickFinder index for documents in the Caching mailbox 
E index QuickFinder index for messages in the Caching mailbox 
E wpcsin Input queue for the Caching mailbox 
BN 0-7 Priority subdirectories 


E wpcsout \ofs 


BN 0-7 


E] wpgwsend 
E wpgwrecv 


_] remoten. log 


Output queue for the Caching mailbox 
Priority subdirectories 


Output queue to the Online mailbox 
Input queue from the Online mailbox 


Connection log 


7.6.1 = QWXxxxxx directory 


Your GroupWise Caching mailbox is a directory structure that functions similarly to a post office. 
Like a post office, it contains databases and input/output queues. The default location varies by 
platform. 


For the Windows client, the same directory structure is used for a Caching mailbox as for a Remote 
mailbox. However, a Caching mailbox is a complete copy of your Online mailbox, but you can restrict 
what gets downloaded into your Remote mailbox. The Linux/Mac client does not include the Remote 
mailbox feature. 
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7.6.2 


rofdata directory 


The rofdata directory contains the databases accessed by the GroupWise client when running in 
Caching mode. The databases in rofdata are similar to the databases found in post offices. For 
comparison, see Section 7.2, “Post Office Directory,” on page 64. 


Historical Note: An earlier version of the GroupWise client Remote mode, designed by WordPerfect 
Corporation (WPCorp), was named WP Office Remote. Hence, the rof in rofdata. Some naming 
conventions were originally preserved for backward compatibility. 


msg.db file 

The msg. db file is the cached equivalent of the msgnnn. db files in the ofmsg directory in your post 
office. The msg. db file contains copies of messages from your Online mailbox. 

user.db file 


The user . db file is the cached equivalent of the userxxx. db files in the ofuser directory in your post 
office. 


wprof.db file 


The wprof . db file contains the cached version of the GroupWise Address Book. 

Historical Note: An earlier version of the GroupWise client Remote mode, designed by WordPerfect 
Corporation (WPCorp), was named WP Office Remote. Hence, the wprof in wprof . db. Some naming 
conventions have been preserved for backward compatibility. 


wprof.dc file 


The wprof . de file is the data dictionary for the cached Address Book (wprof.db). 


Historical Note: An earlier version of the GroupWise client Remote mode, designed by WordPerfect 
Corporation (WPCorp), was named WP Office Remote. Hence, the wprof in wprof .dc. Some naming 
conventions have been preserved for backward compatibility. 


ngwguard.db file 


The ngwguard. db file is the guardian database for your Caching mailbox. It is parallel in function to 
the ngwguard. db file in the post office. 


ngwguard.dc file 


The ngwguard. dc file is the data dictionary for building the databases in the GroupWise Caching 
mailbox. It is parallel in function to the ngwguard. dc file in the post office. 


ngwguard.rfl file 
The ngwguard.rf1 file is a roll-forward transaction log of every database transaction that has taken 


place since the last copy of the ngwguard. fbk file was created. It is parallel in function to the 
ngwguard.rfl file in the post office. 
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ngwguard.fbk 


The ngwguard. fbk file “fall back” copy of the ngwguard. db file. It is parallel in function to the 
ngwguard. fbk file in the post office. 


puxxxxx.db files 
The puxxxxx. db files are databases for replicated items such as shared folders. These databases 


prevent conflicts between user names of shared items from users in other post offices and user names 
in your own post office. They are parallel to the puxxxxx. db files in the post office. 


ngwcheck.db file 


The ngwcheck . db file tracks GroupWise Check threads and the databases being checked. In the 
GroupWise client, GroupWise Check is run using Tools > Repair Mailbox. 


gwcheckn.log 


The gwcheckn. log file records any errors that occurred during mailbox repair. For assistance with 
GroupWise Check errors, see “GroupWise Check Error Codes” in “Administration Error Messages’ 
in the GroupWise 8 Troubleshooting 1: Error Messages. 


Y 


gwdms directory 
The gwdms directory is the Document Management Services directory. It contains information about 


the libraries in your GroupWise system. It has the same structure as the gwdms subdirectory in the 
post office. 


dmsh.db file 


The dmsh. db file is a database shared by all libraries that contains a list of all available libraries and 
lookup tables for each library. 


dmxxnn01-FF.db files 


The dmxxnn01-FF.db files are databases for library and document information. They are parallel to 
the dmxxnn01-FF.db files in the post office. 


docs directory 


The docs directory holds cached copies of the documents in your Online mailbox. 


index directory 


The index directory under the gwdms directory contains the QuickFinder index for the documents in 
your Caching mailbox. 


index directory 


The index directory under the rofdata directory contains the QuickFinder index for the messages in 
your Caching mailbox. 
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7.6.3 


7.6.4 


7.6.5 


wpcsin directory 


The wpcsin subdirectory is the input queue for the connection that transfers messages to your 
GroupWise system for delivery. Messages from the GroupWise client in Caching mode are processed 
through the priority 1 subdirectory of wpcsin. 


When you send a message in Caching mode, the GroupWise client connects to your GroupWise 
system. It polls the wpcsin\1 directory and compresses any outgoing messages, requests, or both 
into a file. If the compressed file totals over 50 KB, additional compressed files are created. The 
GroupWise client then moves the compressed files into the wogwsend directory. 


Historical Note: WP Office, the predecessor of GroupWise, was originally designed by WordPerfect 
Corporation (WPCorp). The Message Transfer Agent (MTA) was originally named the Connection 
Server (CS). Hence, the directory name wpcsin for the input queue, although the MTA is not involved 
in processing messages in your Caching mailbox. Some naming conventions were originally 
preserved for backward compatibility. 


0-7 directories 


The priority 0-7 subdirectories in the connection input queue (wpcsin) parallel those found in the 
wpcsin directory in your post office. 


wpcsoutlofs directory 


The wpcsout \ofs directory is the output queue for the connection that transfers messages from your 
Online mailbox. Messages from your GroupWise system are processed through the priority 1 
subdirectory of wpcsout \ofs. 


The GroupWise client scans the wpcsout \ofs\1 subdirectory and updates the user. db and msg. db 
files with the information received from your Online mailbox. 


Historical Note: WP Office, the predecessor of GroupWise, was originally designed by WordPerfect 
Corporation (WPCorp). The Message Transfer Agent (MTA) was originally named the Connection 
Server (CS). Hence, the directory names wpcsin and ofs for the input queue, though the MTA is not 
involved in processing messages in your Remote mailbox. Some naming conventions were originally 
preserved for backward compatibility. 


0-7 directories 


The priority 0-7 subdirectories in the connection output queue (wpcsout \ofs) parallel those found 
in the ofs directory in your post office. 


wpgwsend directory 


The wpgwsend directory holds compressed files that contain outgoing messages, requests, or both. 
When a connection to your GroupWise system is established, the GroupWise client uploads the files 
to your Online mailbox. 


Historical Note: WP Office Remote, the predecessor of the GroupWise client Remote mode, was 
originally designed by WordPerfect Corporation (WPCorp). Hence, the name wpgwsend. Some 
naming conventions were originally preserved for backward compatibility. 
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7.6.6 wpgwrecv directory 


The wogwrecv directory holds compressed files that contain messages or other information that have 
been received from your Online mailbox. The GroupWise client decompresses the files and places the 
message files into the wocsout \ofs\1 directory. 


Historical Note: WP Office Remote, the predecessor of the GroupWise client Remote mode, was 
originally designed by WordPerfect Corporation (WPCorp). Hence, the name wogwrecv. Some 


naming conventions were originally preserved for backward compatibility. 


7.6.7  remoten.log 


The remoten. log files are saved versions of the connection logs you can view in the GroupWise 
client by clicking Accounts > Connection Log. These log files can be useful for troubleshooting 


problems with your connection to your Online mailbox. 


7.7 Remote Mailbox Directory 


EN] remote_mailbox 


E rofdata 
_] msg.db 
_] user .db 
LJ wprof .db 
O wprof.dc 


_] ngwguard.db 
_] ngwguard.de 
B ngwguard.rfl 
ngwguard. fbk 


LJ puxxxxx.db 


_] ngwcheck. db 
LJ gwcheckn. log 


=| gwdms 
_] dmsh. db 
_] dmxxnn01-FF.db 
HA] docs 
E index 


MD wecsout\ofs 
BE 0-7 


Es] wpgwsend 
el wpgwrecv 


GroupWise mailbox on a remote computer 


Remote database directory 

Remote message database 

Remote user database 

Remote Address Book 

Data dictionary for Remote Address Book 


Remote guardian database 

Data dictionary for Remote guardian database 
Guardian database roll forward log 

Guardian database “fall back” file 


Database for shared folders 


GroupWise Check database 
Log file created by the Repair Mailbox feature 


Document Management Services directory 

Shared DMS database 

Document databases 

Subdirectory for documents in the Remote mailbox 
QuickFinder index for Remote mailbox 


QuickFinder index for messages in the Remote mailbox 


Input queue for the GroupWise client in Remote mode 
Priority subdirectories 


Output queue for the GroupWise client in Remote mode 
Priority subdirectories 


Output queue to master mailbox 
Input queue from master mailbox 
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7.1.1 


1.1.2 


_] remoten.log Remote connection log 


remote_mailbox directory 


The GroupWise remote mailbox is a directory structure that functions similarly to a post office. Like a 
post office, it contains databases and input/output queues. 


rofdata directory 


The rofdata subdirectory in the remote mailbox directory contains the databases accessed by the 
GroupWise client in Remote mode. The databases in rofdata are similar to the databases found in 
post offices. 


Historical Note: An earlier version of the GroupWise client Remote mode, designed by WordPerfect 
Corporation (WPCorp), was named WP Office Remote. Hence, the rof in rofdata. Some naming 
conventions were originally preserved for backward compatibility. 


msg.db file 


The msg. db file in the remote data directory (rofdata) in the remote mailbox directory is the remote 
equivalent of the msgnnn. db files in the ofmsg directory in the post office where your master mailbox 
is located. The msg. db file contains messages you have downloaded from your master mailbox. 


user.db file 


The user . db file in the remote data directory (rofdata) in the remote mailbox directory is the remote 
equivalent of the userxxx. db files in the ofuser directory in the post office where your master 
mailbox is located. The user. db file contains user information you have downloaded from your 
master mailbox. 


wprof.db file 


The wprof . db file in the remote data directory (rofdata) in the Remote mailbox directory contains 
the remote version of the GroupWise Address Book if you have downloaded it. 


Historical Note: An earlier version of the GroupWise client Remote mode, designed by WordPerfect 
Corporation (WPCorp), was named WP Office Remote. Hence, the wprof in wprof . db. Some naming 
conventions have been preserved for backward compatibility. 


wprof.dc file 


The wprof .dc file in the remote data directory (rofdata) in the Remote mailbox directory is the data 
dictionary for the remote Address Book (wprof . db). 


Historical Note: An earlier version of the GroupWise client Remote mode, designed by WordPerfect 
Corporation (WPCorp), was named WP Office Remote. Hence, the wprof in wprof .dc. Some naming 
conventions have been preserved for backward compatibility. 
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ngwguard.db file 


The ngwguard. db file in the remote data directory (rofdata) in the Remote mailbox directory is the 
guardian database for the remote GroupWise mailbox. Itis parallel in function to the ngwguard. db 
file in the post office. 


ngwguard.dc file 


The ngwguard. dc file in the remote data directory (rofdata) in the Remote mailbox directory is the 
data dictionary for building the databases in the remote GroupWise mailbox. It is parallel in function 
to the ngwguard. de file in the post office. 


ngwguard.rfl file 


The ngwguard.rf1 file is a roll-forward transaction log of every database transaction that has taken 
place since the last copy of the ngwguard. fbk file was created. It is parallel in function to the 
ngwguard.rfl file in the post office. 

ngwguard.fbk 

The ngwguard. fbk file “fall back” copy of the ngwguard. db file. It is parallel in function to the 
ngwguard. fbk file in the post office. 


puxxxxx.db files 


The puxxxxx. db files in the remote data directory (rofdata) in the Remote mailbox directory are 
databases for replicated items such as shared folders. These databases prevent conflicts between user 
names of shared items from users in other post offices and user names in the Remote user’s post 
office. They are parallel to the puxxxxx. db files in the post office. 


ngwcheck.db file 

The ngwcheck . db file tracks GroupWise Check threads and the databases being checked. In Remote 
mode in the GroupWise client, GroupWise Check is run using Tools > Repair Mailbox. 
gwcheckn.log 


The gwcheckn. log file records any errors that occurred during Remote mailbox repair. For assistance 
with GroupWise Check errors, see “GroupWise Check Error Codes” in “Administration Error 
Messages” in the GroupWise 8 Troubleshooting 1: Error Messages. 


gwdms directory 


The gwdms subdirectory in the remote data directory (rofdata) in the remote mailbox directory is the 
Document Management Services directory. It contains the document libraries you have downloaded 
from your master GroupWise system. It has the same structure as the gwdms subdirectory in the post 
office. 


dmsh.db file 


The dmsh. db file is a database shared by all libraries that have been downloaded to your remote 
GroupWise mailbox. It contains a list of all available libraries and lookup tables for each library. 
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7.1.3 


7.1.4 


dmxxnn01-FF.db files 


The dmxxnn01 -FF. db files are databases for library and document information. They are parallel to 
the dmxxnn01-FF.db files in the post office. 


docs directory 


The docs directory holds cached copies of the documents in your Remote mailbox. 


index directory 


The index directory contains the QuickFinder index for the documents contained in the library. 


index directory 


The index directory under the rofdata directory contains the QuickFinder index for the messages in 
your Remote mailbox. 


wpcsin directory 


The wpcsin subdirectory in the remote mailbox directory is the input queue for the connection that 
transfers messages to your master GroupWise system. Messages from the GroupWise client in 
Remote mode are processed through the priority 1 subdirectory of wpcsin. 


When the user initiates the connection to the master GroupWise system, the GroupWise client polls 
the wecsin\1 directory and compresses the outgoing messages, requests, or both into a file. If the 
compressed file totals over 50 KB, additional compressed files are created. The GroupWise client then 
moves the compressed files into the wpgwsend directory. 


Historical Note: WP Office, the predecessor of GroupWise, was originally designed by WordPerfect 
Corporation (WPCorp). The Message Transfer Agent (MTA) was originally named the Connection 
Server (CS). Hence, the directory name wpcsin for the input queue, although the MTA is not involved 
in processing messages in your Remote mailbox. Some naming conventions were originally 
preserved for backward compatibility. 


0-7 directories 


The priority 0-7 subdirectories in the connection input queue (wpcsin) in the remote mailbox 
directory parallel those found in the wpcsin directory in the remote user’s post office on the master 
GroupWise system. 


wpcsoutlofs directory 


The wpcsout \ofs subdirectory in the remote mailbox directory is the output queue for the 
connection that transfers messages from your master GroupWise system. Messages from the 
GroupWise client in Remote mode are processed through the priority 1 subdirectory of wpcsout\ ofs. 


In Remote mode, the GroupWise client scans the wpocsout \ofs\1 subdirectory and updates the 
user.db and msg. db files with the information received from the master mailbox. 
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7.1.5 


7.1.6 


1.1.1 


Historical Note: WP Office, the predecessor of GroupWise, was originally designed by WordPerfect 
Corporation (WPCorp). The Message Transfer Agent (MTA) was originally named the Connection 
Server (CS). Hence, the directory names wpcsin and ofs for the input queue, though the MTA is not 
involved in processing messages in your Remote mailbox. Some naming conventions were originally 
preserved for backward compatibility. 


0-7 directories 


The priority 0-7 subdirectories in the connection output queue (wpcsout \ofs) in the remote mailbox 
directory parallel those found in the ofs subdirectory in the remote user’s post office on the master 
GroupWise system. 


wpgwsend directory 


The wpgwsend subdirectory in the remote mailbox directory holds compressed files that contain 
outgoing messages, requests, or both. When a connection to your master GroupWise system is 
established, the GroupWise client uploads the files across the link from the remote computer to the 
master GroupWise system. 


Historical Note: WP Office Remote, the predecessor of the GroupWise client Remote mode, was 
originally designed by WordPerfect Corporation (WPCorp). Hence, the name wpgwsend. Some 
naming conventions were originally preserved for backward compatibility. 


wpgwrecv directory 


The wpgwrecv subdirectory in the remote mailbox directory holds compressed files that contain 
messages or other information that have been downloaded from your master mailbox. The 
GroupWise client decompresses the files and places the message files into the wpcsout \ofs\1 
directory. 


Historical Note: WP Office Remote, the predecessor of the GroupWise client Remote mode, was 
originally designed by WordPerfect Corporation (WPCorp). Hence, the name wpgwrecv. Some 
naming conventions were originally preserved for backward compatibility. 


remoten.log 


The remoten. log files in the connection output queue (wpcsout \ofs) in the remote mailbox 
directory are saved versions of the connection logs you can view in the GroupWise client in Remote 
mode. These log files can be useful for troubleshooting problems with your modem or with your 
connection to your master GroupWise system. 
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8.1 


8.1.1 


Agent Installation Directories 


¢ Section 8.1, “GroupWise Agent Installation (POA and MTA),” on page 99 
+ Section 8.2, “Internet Agent Installation,” on page 110 

+ Section 8.3, “WebAccess Agent Installation,” on page 117 

+ Section 8.4, “Monitor Agent Installation,” on page 127 


GroupWise Agent Installation (POA and MTA) 


The Post Office Agent (POA) and the Message Transfer Agent (MTA) are always installed together. 
The agent installation directory differs depending on the platform where the agents are installed. 


+ Section 8.1.1, “NetWare Installation Directory,” on page 99 
+ Section 8.1.2, “Linux Installation Directory,” on page 103 


+ Section 8.1.3, “Windows Installation Directory,” on page 108 


NetWare Installation Directory 


E sys: system NetWare agent installation directory 


O gwenn5.nlm 
_] gwpoa.nlm 
U gwmta.nlm 


L strtupxx.poa 
LJ strtupxx.mta 


L post_office.poa 
_] domain.mta 


J gwpoanxx.hlp 
J gwmtanxx.hlp 


_] gwooanxx. fil 
LJ gwmtanxx.fil 


_] grpwise.ncf 


_] x*5.nlm 
_] gwxis12.nlm 


_j agent .xml 


GroupWise 8 Agent Engine 
Post Office Agent (POA) program 
Message Transfer Agent (MTA) program 


Boilerplate POA startup file 
Boilerplate MTA startup file 


POA startup file for a specific post office 
MTA startup file for a specific domain 


POA online help files 
MTA online help files 


POA language information files 
MTA language information files 


Agent load file 


XIS NLM programs 
GroupWise XIS NLM program 


XIS agent configuration files 
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_] gwtsa.nlm GroupWise Target Service Agent (GWTSA) program 


_] gwtsaxx.fil GWTSA language information files 

J gwtsa.ncf GWTSA load file 

_] gwtmstmp.nlm GroupWise Time Stamp program 

_] dbcopy.nlm GroupWise Database Copy program 

el help Subdirectory for GroupWise agent Web console help files 


NetWare agent installation directory 


When you first install GroupWise Administration, the GroupWise agents are installed in platform- 
specific subdirectories in the agent directory in the software distribution directory. However, the 
agents cannot be run from this initial location. They must be installed on the servers where they will 
run. 


On a NetWare server, the GroupWise agents are typically installed in the sys: system directory. You 
can choose a different location during installation. 


gwenn5.nim file 


The gwenn5 .n1m file is the GroupWise 8 Agent Engine, a program that is shared by all GroupWise 
agents. It provides the following services to the agents: 

+ Database management 

¢ File operations 

+ Message handling 

+ Thread management 

+ Semaphores (file/record locking) 


+ Date/time services 


The first agent loaded on a server automatically loads the GroupWise Agent Engine. 


gwpoa.nim file 
The gwpoa .nlm file is the Post Office Agent program. You load this NLM program to start the Post 


Office Agent. See “Starting the NetWare GroupWise Agents” in “Installing GroupWise Agents” in 
the GroupWise 8 Installation Guide. 


gwmta.nIm file 
The gwmta.nlm is the Message Transfer Agent program. You load this NLM program to start the 


Message Transfer Agent. See “Starting the NetWare GroupWise Agents” in “Installing GroupWise 
Agents” in the GroupWise 8 Installation Guide. 
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strtupxx.poa file 


The POA startup file contains startup switches for the POA. Switch settings placed in the POA 
startup file override comparable options set for the POA in ConsoleOne. The xx in the startup 
filename represents a two-letter language code. 


During installation, a customized version of the POA startup file, named post_office.poa, is 
created. This customized version has the /home startup switch automatically set to the post office 
directory the POA will service. See “Using POA Startup Switches” in “Post Office Agent” in the 
GroupWise 8 Administration Guide. 


strtupxx.mta file 


The MTA startup file contains startup switches for the MTA. Switch settings placed in the MTA 
startup file override comparable options set for the MTA in ConsoleOne. The xx in the startup 
filename represents a two-letter language code. 


During installation, a customized version of the MTA startup file, named domain.mta, is created. 
This customized version has the /home startup switch automatically set to the domain directory the 
MTA will service. See “Using MTA Startup Switches” in “Message Transfer Agent” in the GroupWise 
8 Administration Guide. 


nlm_agentnxx.hlp files 


Online help is available by pressing F1 at the agent console on the server where it runs. See “Using 
the POA Server Console” in “Post Office Agent” and “Using the MTA Server Console” in “Message 
Transfer Agent” in the GroupWise 8 Administration Guide 


The first five characters of the filename are the agent name. The digit n is a version number. The last 
two characters xx are a language code. 


nlm_agentnxx.fil files 


These files contain all language-specific information for the POA and the MTA. The first five 
characters of the filename are the agent name. The digit n is a version number. The last two characters 
xx are a language code. 


grpwise.ncf file 


The grpwise.ncf file is the NetWare configuration file that automatically loads the agents whenever 
the server is restarted. A typical grpwise.ncf file would look similar to the following: 


load sys:\system\gwmta.nlm @corpdom.mta 
load sys:\system\gwpoa.nlm @acctpo.poa 


For more information, see “Starting the NetWare GroupWise Agents” in “Installing GroupWise 
Agents” in the GroupWise 8 Installation Guide. 


x*5.nlm and gwxis12.nlm files 


The x*5.nlmand gwxis12.n1m programs provide XIS capability for the GroupWise agents, so that 
you can create XML documents to monitor and change the agents as needed. 
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nlm_agent.xml files 


The n1m_agent.xml files are specialized agent configuration files for use in the XIS environment. 


gwtsa.nim file 


The gwtsa .nlm file is the GroupWise Target Service Agent (GWTSA), which provides reliable 
backups of a running GroupWise system by successfully backing up open files and locked files, 
rather than skipping them as some backup software does. For more information, see “GroupWise 
Target Service Agent” in “Databases” in the GroupWise 8 Administration Guide. 


gwtmstmp.nIm file 


If you use the GroupWise Target Service Agent (GWTSA) of the GroupWise Target Server Agent for 
File Systems (TSAFSGW) to back up your GroupWise system, the time stamping is an automatic part 
of the backup process. However, if you choose not to use one of these TSAs, you must still make sure 
that user databases are time-stamped so that items are not prematurely purged. The gwtmstmp.nlm 
accomplishes this task. For more information, see “GroupWise Time Stamp Utility” in “Databases” in 
the GroupWise 8 Administration Guide. 


dbcopy.nlm file 


The dbcopy .n1m file is the GroupWise Database Copy utility, which copies files from a live 
GroupWise post office or domain to a static location for backup. During the copy process, DBCopy 
prevents the files from being modified, using the same locking mechanism used by other GroupWise 
programs that access databases. This ensures that the backed-up versions are consistent with the 
originals even when large databases take a substantial amount of time to copy. For more information, 
see “GroupWise Database Copy Utility” in “Databases” in the GroupWise 8 Administration Guide. 


gwtsaxx.fil file 


These files contain all language-specific information for the GWTSA. The last two characters, xx, are a 
language code. 


gwtsa.ncf file 


The gwtsa.ncf file is the NetWare configuration file that automatically loads the GWTSA whenever 
the server is restarted. A typical gwtsa.ncf file would look similar to the following: 


load sys:\system\smdr 


load sys:\system\gwtsa /home-sys:\gwsystem\corpdom 
/home-sys:\gwsystem\acctpo 


help directory 
The help directory contains language-specific subdirectories for the help files available from the 


POA and MTA Web consoles. See “Using the POA Web Console” in “Post Office Agent” and “Using 
the MTA Web Console” in “Message Transfer Agent” in the GroupWise 8 Administration Guide. 
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8.1.2 


Linux Installation Directory 


E /opt/novell/groupwise/agents 


Ë bin 
_] gwpoa 
] gwmta 
] gwha 


J gwpoa.xml 
O gwmta.xml 


O strtupxx.poa 
O strtupxx.mta 


_] gwesrgen 

L] gwtmstmp 
lib 

_] gwpoaxxx. fil 

Ll gwmtaxxx.fil 


_] libpoa.so* 

_] libpoa ui.so* 
_] libmta.so* 

_] libmta_ui.so* 
_] libgwha.so* 
LÌ *.so* 


E image 
E share 


O post office. poa 


_] domain.mta 


Es] agtcon 


E help 


E webcon 


EN] help 


HH] gwesrgen 


BN] help 


EN] /etc/init.d 


_] grpwise 
HN] rc3.d 
O Snngrpwise 


Mi rcs.d 
_] Snngrpwise 


Linux agent installation directory 


Subdirectory for GroupWise agent executables 
Post Office Agent (POA) executable 

Message Transfer Agent (MTA) executable 
GroupWise High Availability service executable 


POA XIS configuration file 
MTA XIS configuration file 


Boilerplate POA startup file 
Boilerplate MTA startup file 


GroupWise Generate CSR utility 
GroupWise Time Stamp utility 


Subdirectory for GroupWise agent library files 
POA language information file 
MTA language information file 


POA shared library files 

POA shared library files for the optional user interface 
MTA-specific library files 

MTA-specific library files for the optional user interface 
GroupWise High Availability service library files 
Supporting library files 


Subdirectory for icon images 


Subdirectory for agent shared files 
POA startup file for a specific post office 
MTA startup file for a specific domain 


Subdirectory for agent console files 
Subdirectory agent console help files 


Subdirectory for agent Web console files 
Subdirectory for agent Web console help files 


Subdirectory for the GWCSRGEN utility files 
Subdirectory for GWCSRGEN utility help files 


Standard Linux location for application startup scripts 
Startup script for the POA and MTA 


Standard Linux location for runlevel-3 symbolic links 
Symbolic link to the startup script for the POA and MTA 


Standard Linux location for runlevel-5 symbolic links 
Symbolic link to the startup script for the POA and MTA 
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EN] /etc/opt Standard Linux location for application configuration files 


E novell/groupwise Subdirectory for GroupWise configuration files 
_] gwha.conf GroupWise High Availability service configuration file 
HH] agents Subdirectory for GroupWise agents 
Juid.conf Agent configuration file for running as a non-root user 
ES /var/log/ Standard Linux location for application log files 
B®) novell /groupwise Subdirectory for GroupWise agent log files 
Ža post_office.poa Post office-specific subdirectory for POA log files 
_] mmddpoa. nnn POA log files 
HN] domain.mta Domain-specific subdirectory for MTA log files 
_] mmddmta.nnn MTA log files 


agents directory 
On a Linux server, the agents are always installed in subdirectories of /opt /novell/groupwise/ 
agents. 


bin directory 


The bin directory holds GroupWise executable files. 


gwpoa file 


The gwpoa file is the Post Office Agent executable. You run this executable file to start the Post Office 
Agent. See “Starting the Linux Agents with a User Interface” in “Installing GroupWise Agents” in the 
GroupWise 8 Installation Guide. 


gwmta file 


The gwmta file is the Message Transfer Agent executable. You run this executable file to start the 
Message Transfer Agent. See “Starting the Linux Agents with a User Interface” in “Installing 
GroupWise Agents” in the GroupWise 8 Installation Guide. 


gwha file 


The gwha file is the GroupWise High Availability service executable. If the POA or the MTA goes 
down for any reason, the High Availability service automatically restarts it. See “Enabling the 
Groupwise High Availability Service for the Linux GroupWise Agents” in “Installing GroupWise 
Agents” in the GroupWise 8 Installation Guide. 


* xml files 


The agent .xm1 files are specialized agent configuration files for use in the XIS environment. 


strtupxx.poa file 


The strtupxx. poa file is the boilerplate file from which a post office-specific post_office.poa file is 
created in the share directory. The xx in the startup filename represents a two-letter language code. 
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strtupxx.mta file 


The strtupxx.mta file is the boilerplate file from which a domain-specific domain.poa file is created 
in the share directory. The xx in the startup filename represents a two-letter language code. 


gwesrgen file 


The gwesrgen file is the GroupWise Generate CSR utility. If you enable SSL for the agents, they need 
access to a server certificate and private key. You can use the GroupWise Generate CSR utility 
(GWCSRGEN) to generate a Certificate Signing Request (CSR) file and a Private Key file. For more 
information, see “Server Certificates and SSL Encryption” in “Security Administration” in the 
GroupWise 8 Administration Guide. 


gwtmstmp file 


The gwtmstmp file is the GroupWise Time Stamp utility. If you deselect Allow Purge of Items Not 
Backed Up in ConsoleOne, user databases (userxxx.db) must be time-stamped every time a backup 
is performed so that items can be purged only after being backed up. You can use the GroupWise 
Time Stamp (GWTMSTMP) utility to ensure that GroupWise user databases include the dates when 
they were last backed up, restored, and retained. For more information, see “GroupWise Time Stamp 
Utility” in “Databases” in the GroupWise 8 Administration Guide. 


lib directory 


The lib directory holds GroupWise library files. 


* fil files 


These files contain all language-specific information for the POA and the MTA. The first five 
characters of the filename are the agent name. The last two characters xx are a language code. 


* so* files 


These files are Linux library files that provide information to the GroupWise executables. 


image directory 


The image directory has subdirectories for agent icons for both color and monochrome displays. 


share directory 


The share directory holds agent startup files and files that are used by the agent consoles and Web 
consoles. 


post_office.poa 


The POA startup file contains startup switches for the POA. Switch settings placed in the POA 
startup file override comparable options set for the POA in ConsoleOne. 


During installation, a customized version of the strtupxx.poa file, named post_office.poa, is 
created in the share directory. This customized version has the --home startup switch automatically 
set to the post office directory the POA will service. See “Using POA Startup Switches” in “Post 
Office Agent” in the GroupWise 8 Administration Guide. 
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domain.mta 


The MTA startup file contains startup switches for the MTA. Switch settings placed in the MTA 
startup file override comparable options set for the MTA in ConsoleOne. 


During installation, a customized version of the strtupxx.mta file, named domain.mta, is created in 
the share directory. This customized version has the --home startup switch automatically set to the 
domain directory the MTA will service. See “Using MTA Startup Switches” in “Message Transfer 
Agent” in the GroupWise 8 Administration Guide. 


agtcon directory 


The agtcon directory holds subdirectories and files used by the agent consoles, such as help files. See 
“Using the POA Server Console” in “Post Office Agent” and “Using the MTA Server Console” in 
“Message Transfer Agent” in the GroupWise 8 Administration Guide. 


webcon directory 


The webcon directory holds subdirectories and files used by the agent Web consoles, such as help 
files. See “Using the POA Web Console” in “Post Office Agent” and “Using the MTA Web Console” 
in “Message Transfer Agent” in the GroupWise 8 Administration Guide. 


gwesrgen directory 


The gwesrgen directory holds subdirectories and files used by the GroupWise Generate CSR 
(GWCSRGEN) utility, such as help files. See “Generating a Certificate Signing Request” in “Security 
Administration” in the GroupWise 8 Administration Guide. 


letclinit.d directory 


The /etc/init .d directory is the standard location for Linux startup scripts. 


grpwise file 


The grpwi se script is created automatically during installation. You can use the script to start, restart, 
stop, and display status information about the POA and MTA. For more information about starting 
the agents, see “Installing and Starting the Linux GroupWise Agents” in “Installing a Basic 
GroupWise System” in the GroupWise 8 Installation Guide. 


rc3.d directory 


The rc3 .d directory holds symbolic links to scripts that you want your Linux server to run when it is 
booted to runlevel 3 (multi-user; boots to a text mode login prompt without the X Window System). 
The symbolic link to the grpwise script is Snngrpwise. It is created if you choose during installation 
to have the agents start automatically when the server boots. See “Starting the Linux GroupWise 
Agents on System Startup” in “Installing GroupWise Agents” in the GroupWise 8 Installation Guide. 


rc5.d directory 


The rc5 .d directory holds symbolic links to scripts that you want your Linux server to run when it is 
booted to runlevel 5 (multi-user; boots to the X Window System login dialog box). The symbolic link 
to the grpwise script is Snngrpwise. It is created if you choose during installation to have the agents 
start automatically when the server boots. See “Starting the Linux GroupWise Agents on System 
Startup” in “Installing GroupWise Agents” in the GroupWise 8 Installation Guide. 
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letcloptinovelllgroupwise directory 


The /etc/opt directory is the standard location of application configuration files on Linux. Files that 
configure how the GroupWise agents interact with Linux are stored in the novell/groupwise 
subdirectory. 


gwha.conf file 


The gwha. conf file is the GroupWise High Availability service configuration file. It is created 
automatically during installation and provides the information necessary for the High Availability 
service to restart the GroupWise agents if they go down unexpectedly. See “Enabling the Groupwise 
High Availability Service for the Linux GroupWise Agents” in “Installing GroupWise Agents” in the 
GroupWise 8 Installation Guide. 


uid.conf file 


The uid. conf file configures the GroupWise agents to run as a non-root user. See “Running the 
Linux GroupWise Agents As a Non-root User” in “Installing GroupWise Agents” in the GroupWise 8 
Installation Guide. 


Ivarllog/novell/groupwise directory 


The /var/1log directory is the standard location for log files on Linux. All GroupWise agent log files 
are created in the novell /groupwise subdirectory. 


post_office.poa directory 
The post_office.poa directory is a post office-specific location for POA log files. 


Within the post_office.poa directory, the POA creates log files (mmddpoa. nnn) to inform you of its 
processing and any problems it encounters. For more information about log files, see “Using POA 
Log Files” in “Post Office Agent” in the GroupWise 8 Administration Guide guide. 


The first two digits of the filename represent the month, the next two digits represent the day of the 
month, and the next three characters indicate what program created the log. The three-digit 
extension is a sequence number for multiple log files created on the same day. For example, 
0518poa. 002 is the second POA log file created on May 18. 


domain.mta directory 
The domain.mta directory is a domain-specific location for MTA log files. 


Within the domain.mta directory, the MTA creates log files (mmddxxx. nnn) to inform you of its 
processing and any problems it encounters. For more information about log files, see “Using MTA 
Log Files” in “Message Transfer Agent” in the GroupWise 8 Administration Guide. 


The first two digits of the filename represent the month; the next two digits represent the day of the 
month; the next three characters indicate what program created the log. The three-digit extension is a 
sequence number for multiple log files created on the same day. For example, 0518mta.002 is the 
second MTA log file created on May 18. 
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8.1.3 Windows Installation Directory 


Mc: \Program Files\Novell\GroupWise 
Server\Agents 

L gwenvla.dll 

_] gwpoa.exe 

_] gwmta.exe 


_] strtupxx.poa 

JJ strtupxx.mta 

_] post _office.poa 
J domain.mta 


J post_office.poa 
_] domain.mta 


Windows agent installation directory 


GroupWise Agent Engine 
Post Office Agent (POA) program 
Message Transfer Agent (MTA) program 


Boilerplate POA startup file 
Boilerplate MTA startup file 
Customized POA startup file 
Customized MTA startup file 


POA startup file for a specific post office 
MTA startup file for a specific domain 


_] gwpoanxx.chm POA online help file 


_] gwmtanxx. chm MTA online help file 


O gwpoanxx.dll 
O gwmtanxx.dll 


POA language information files 


MTA language information files 
_] gwsnmp.d11 Customized DLL program for SNMP 
L] gwwww1.d11 Customized DLL program for MIME 


L]x*10a.d11 
_] gwxis10.d11 


XIS DLL programs 
GroupWise XIS DLL program 





_] agent .xml XIS agent configuration files 


_] dbcopy.exe GroupWise Database Copy program 


@ help Subdirectory for GroupWise agent Web console help files 


c:\Program Files\Novell\GroupWise\Agents 


When you first install GroupWise Administration, the GroupWise agents are initially installed in 
platform-specific subdirectories in the agent directory of the software distribution directory. 
However, the agents cannot be run from this initial location. They must be installed on the servers 
where they will run. 


On a Windows server, the GroupWise agents can be installed in any directory you choose. The 
default is c:\Program Files\Novell\GroupWise\Agents. The agent icons are set up to include the 
full path to whatever directory you choose. 


gwenv1a.dll file 


The gwenvla.d11 file is the GroupWise Agent Engine, a program that is shared by both GroupWise 
agents. It provides the following services to the agents: 

+ Database management 

+ File operations 


+ Message handling 


108 GroupWise 8 Troubleshooting 3: Message Flow and Directory Structure 


+ Thread management 
+ Semaphores (file/record locking) 


+ Date/time services 


The first agent started on a server automatically starts the GroupWise Agent Engine DLL. 


gwpoa.exe file 


The gwpoa . exe file is the Post Office Agent program. You run this executable file to start the Post 
Office Agent. See “Starting the Windows GroupWise Agents” in “Installing GroupWise Agents” in 
the GroupWise 8 Installation Guide. 


gwmta.exe file 


The gwmta . exe file is the Message Transfer Agent program. You run this executable file to start the 
Message Transfer Agent. See “Starting the Windows GroupWise Agents” in “Installing GroupWise 
Agents” in the GroupWise 8 Installation Guide. 


gwsnmp.dll file 


The gwsnmp . d11 file provides interaction with the Windows SNMP Service, so that you can monitor 
the GroupWise agents using an SNMP monitoring program. 


gwwww1.dll file 


The gwwww1 .d11 file provides parsing of MIME messages received from the Internet. 


strtupxx.poa file post_office.poa file 


The POA startup file contains startup switches for the POA. Switch settings placed in the POA 
startup file override comparable options set for the POA in ConsoleOne. The xx in the startup 
filename represents a two-letter language code. 


During installation, a customized version of the POA startup file, named post_office.poa, is 
created. This customized version has the /home startup switch automatically set to the post office 
directory the POA will service. See “Using POA Startup Switches” in “Post Office Agent” in the 
GroupWise 8 Administration Guide. 


strtupxx.mta file domain.mta file 


The MTA startup file contains startup switches for the MTA. Switch settings placed in the MTA 
startup file override comparable options set for the MTA in ConsoleOne. The xx in the startup 
filename represents a two-letter language code. 


During installation, a customized version of the MTA startup file, named domain.MTA, is created. 
This customized version has the /home startup switch automatically set to the domain directory the 
MTA will service. See “Using MTA Startup Switches” in “Message Transfer Agent” in the GroupWise 
8 Administration Guide. 
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agentnxx.chm files 
The .chm files contain the online documentation for the agents. Online Help is available by clicking 


Help in the agent consoles on the server where the agents are running. In addition, dialog boxes have 
a Help button for context-sensitive Help. 


The first five characters of the filename are the agent name. The digit n is a version number. The last 
two characters xx are a language code. 


agentnxx.dll files 


The agentnxx.d11 files contain all language-specific information for the agents. The digit n is a 
version number. The last two characters xx are a language code. 


x*10a.dll and gwxis10.dll files 


The x*10a.d11 and gwxis10.d11 programs provide XIS capability for the GroupWise agents, so that 
you can create XML documents to monitor and change the agents as needed. 


agent.xml files 


The agent .xml files are specialized agent configuration files for use in the XIS environment. 


dbcopy.exe file 


The dbcopy . exe file is the GroupWise Database Copy utility, which copies files from a live 
GroupWise post office or domain to a static location for backup. During the copy process, DBCopy 
prevents the files from being modified, using the same locking mechanism used by other GroupWise 
programs that access databases. This ensures that the backed-up versions are consistent with the 
originals even when large databases take a substantial amount of time to copy. For more information, 
see “GroupWise Database Copy Utility” in “Databases” in the GroupWise 8 Administration Guide. 


help directory 


The help directory contains language-specific subdirectories for the help files available from the 
POA and MTA Web consoles. See “Using the POA Web Console” in “Post Office Agent” and “Using 
the MTA Web Console” in “Message Transfer Agent” in the GroupWise 8 Administration Guide. 


8.2 Internet Agent Installation 


+ Section 8.2.1, “NetWare Installation Directory,” on page 110 
+ Section 8.2.2, “Linux Installation Directory,” on page 112 


+ Section 8.2.3, “Windows Installation Directory,” on page 116 


8.2.1 NetWare Installation Directory 


@ sys: system NetWare Internet Agent installation directory 
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L] gwenns .nlm GroupWise 8 Agent Engine 


J gwia.nlm Internet Agent NLM program 

_] gwia.cfg Internet Agent configuration file 

_] gwianxx.fil Internet Agent language information file 

_] gwia.ncf Internet Agent load file 

_] x*5.nlm XIS NLM programs 

_] gwxis12.n1m GroupWise XIS NLM programs 

_] gwia.xml XIS Internet Agent configuration file 

@ help Subdirectory for GroupWise agent console help files 


See also Section 7.5, “Internet Agent Queue Directory,” on page 83. 


NetWare Internet Agent installation directory 


On a NetWare server, the GroupWise Internet Agent is typically installed in the sys: \system 
directory. You can choose a different location during installation. 


gwenn5.nim file 


The gwenn5 .n1m file is the GroupWise 8 Agent Engine, a program that is shared by all GroupWise 
agents. It provides the following services to the agents: 

+ Database management 

+ File operations 

+ Message handling 

+ Thread management 

+ Semaphores (file/record locking) 


+ Date/time services 


The first agent loaded on a server automatically loads the GroupWise Agent Engine. 


gwia.nim file 


The gwia .n1n file is the Internet Agent program. You load this NLM program to start the Internet 
Agent. See “Starting the Internet Agent” in “Installing the GroupWise Internet Agent” in the 
GroupWise 8 Installation Guide. 


gwia.cfg file 


The Internet Agent configuration file contains startup switches for the Internet Agent. Switch settings 
placed in the Internet Agent startup file override comparable options set for the Internet Agent in 
ConsoleOne. The startup file is named the same as the Internet Agent object in ConsoleOne. The 
default is gwia. 


During installation, a customized version of the Internet Agent startup file is created in sys: system. 
This customized version has the /home startup switch automatically set to the domain directory 
where the Internet Agent’s queue directories are located. See “Using Internet Agent Startup 
Switches” in “Internet Agent” in the GroupWise 8 Administration Guide. 
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gwianxx.fil files 


This file contains all language-specific information for the Internet Agent. The digit n is a version 
number. The last two characters xx are a language code. 


gwia.ncf file 


The gwia.ncf file is the NetWare configuration file that automatically loads the Internet Agent 
whenever the server is restarted. A typical gwia .ncf file would look similar to the following: 


load sys:\system\gwia @gwia.cfg 


x*5.nlm and gwxis12.nlm files 


The x*5.nlmand gwxis12.n1m programs provide XIS capability for the GroupWise agents, so that 
you can create XML documents to monitor and change the agents as needed. 


gwia.xml file 


The gwia.xml file is a specialized Internet Agent configuration file for use in the XIS environment. 


8.2.2 Linux Installation Directory 


2 /opt/novell/groupwise/agents Linux agent installation directory 


È bin Subdirectory for GroupWise agent executables 
_] gwia Internet Agent executable 
_] gwia.xml Internet Agent XIS configuration file 
_] gwha GroupWise High Availability service executable 
MN lib Subdirectory for GroupWlse agent library files 
_] gwiaxxx. fil Internet Agent language information file 
_] libgwia.so Internet Agent shared library file 
LÌ libgwia_ui.so Internet Agent user interface shared library file 
_] libgwha.so* GroupWise High Availability service library files 
_] *.so Supporting shared library files 
el image Subdirectory for icon images 
HN] share Subdirectory for agent shared files 
_] gwia.cfg Internet Agent configuration file 
E agtcon Subdirectory for agent console files 
al help Subdirectory agent console help files 
HH] webcon Subdirectory for agent Web console files 
E help Subdirectory for agent Web console help files 
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EN /etc/init.d Standard Linux location for application startup scripts 


_] grpwise Startup script for the Internet Agent 
$ rc3.a Standard Linux location for run-level-3 symbolic links 
_] Snngrpwise Symbolic link to the startup script for the Internet Agent 
a halels ay 6 Standard Linux location for run-level-5 symbolic links 
_] Snngrpwise Symbolic link to the startup script for the Internet Agent 
E /etc/opt Standard Linux location for application configuration files 
dl novell/groupwise Subdirectory for GroupWise configuration files 
_] gwha. conf GroupWise High Availability service configuration file 
el agents Subdirectory for GroupWise agents 
_] uid. conf Agent configuration file for running as a non-root user 
Ea /var/log/ Standard Linux location for application log files 
el novell/groupwise Subdirectory for GroupWise agent log files 
EN] domain. gwia Domain-specific subdirectory for Internet Agent log files 
_] mmddgwia.nnn Internet Agent log files 


See also Section 7.5, “Internet Agent Queue Directory,” on page 83. 


agents directory 


On a Linux server, the Internet Agent is always installed in subdirectories of /opt /novell/ 
groupwise/agents. 


bin directory 

The bin directory holds GroupWise executable files. 

gwia file 

The gwia file is the Internet Agent executable. You run this executable file to start the Internet Agent. 


See “Starting the Internet Agent” in “Installing the GroupWise Internet Agent” in the GroupWise 8 
Installation Guide. 


gwia.xml file 


The gwia.xml file is a specialized configuration file for use in the XIS environment. 


gwha file 


The gwha file is the GroupWise High Availability service executable. If the Internet Agent goes down 
for any reason, the High Availability service automatically restarts it. See “Enabling the Groupwise 
High Availability Service for the Linux GroupWise Agents” in “Installing GroupWise Agents” in the 
GroupWise 8 Installation Guide. 
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lib directory 


The 1ib directory holds GroupWise shared library files. 


gwiaxxx.fil files 


This file contains all language-specific information for the Internet Agent. The last two characters xx 
are a language code. 


* so files 


These files are Linux shared library files that provide information to the Internet Agent executable. 


image directory 


The image directory has subdirectories for agent icons for both color and monochrome displays. 


share directory 


The share directory holds agent startup files and files that are used by the agent consoles and Web 
consoles. 


gwia.cfg 


The Internet Agent configuration file contains startup switches for the Internet Agent. Switch settings 
placed in the Internet Agent configuration file override comparable configuration options set for the 
Internet Agent in ConsoleOne. The startup file is named the same as the Internet Agent object in 
ConsoleOne. The default is gwia. 


During installation, the Internet Agent startup file is created in the share directory with the --home 
startup switch automatically set to the domain directory where the Internet Agent queue directory is 
located. See “Using Internet Agent Startup Switches” in “Internet Agent” in the GroupWise 8 
Administration Guide. 


agtcon directory 


The agtcon directory holds subdirectories and files used by the agent consoles, such as help files. 


webcon directory 


The webcon directory holds subdirectories and files used by the agent Web consoles, such as help 
files. 


letclinit.d directory 

The /etc/init .d directory is the standard location for Linux startup scripts. 

grpwise file 

The grpwise script is created automatically during installation. You can use the script to start, restart, 
stop, and display status information about the Internet Agent. For more information about starting 


the Internet Agent, see “Starting the Internet Agent” in “Installing the GroupWise Internet Agent” in 
the GroupWise 8 Installation Guide. 
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rc3.d directory 


The rc3 .d directory holds symbolic links to scripts that you want your Linux server to run when it is 
booted to runlevel 3 (multi-user; boots to a text mode login prompt without the X Window System). 
The symbolic link to the grpwise script is Snngrpwise. It is created if you choose during installation 
to have the Internet Agent start automatically when the server boots. 


rc5.d directory 


The rc5 .d directory holds symbolic links to scripts that you want your Linux server to run when it is 
booted to runlevel 5 (multi-user; boots to the X Window System login dialog box). The symbolic link 
to the grpwise script is Snngrpwise. It is created if you choose during installation to have the 
Internet Agent start automatically when the server boots. 


letc/opt/novell/groupwise directory 


The /etc/opt directory is the standard location of application configuration files on Linux. Files that 
configure how the GroupWise Internet Agent interacts with Linux are stored in the novel1/ 
groupwise subdirectory. 


gwha.conf file 


The gwha. conf file is the GroupWise High Availability service configuration file. It is created 
automatically during installation and provides the information necessary for the High Availability 
service to restart the Internet Agent ifit goes down unexpectedly. See “Enabling the Groupwise High 
Availability Service for the Linux GroupWise Agents” in “Installing GroupWise Agents” in the 
GroupWise 8 Installation Guide. 


uid.conf file 


The uid.conf file configures the Internet Agent to run as a non-root user. See “Running the Linux 
GroupWise Agents As a Non-root User” in “Installing GroupWise Agents” in the GroupWise 8 
Installation Guide. 


Ivarllog/novell/groupwise directory 


The /var/1log directory is the standard location for log files on Linux. All GroupWise agent log files 
are created in the novell /groupwise subdirectory. 


domain.gwia directory 
The domain.gwia directory is a domain-specific location for Internet Agent log files. 


Within the domain.gwia directory, the Internet Agent creates log files (nmmddgwia . nnn) to inform you 
of its processing and any problems it encounters. For more information about log files, see “Using 
Internet Agent Log Files” in “Internet Agent” in the GroupWise 8 Administration Guide. 


The first two digits of the filename represent the month; the next two digits represent the day of the 
month. The three-digit extension is a sequence number for multiple log files created on the same day. 
For example, 0518gwia.002 is the second Internet Agent log file created on May 18. 
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8.2.3 Windows Installation Directory 


Mic: \Program Files\Novell\GroupWise Windows Internet Agent installation directory 
Server\GWIA 
_] gwenvla.d11 GroupWise Agent Engine 
_] gwia.exe Internet Agent program 
_] gwia.cfg Internet Agent configuration file 
_] gwianxx.chm Internet Agent online help file 
_] gwianxx.d11 Internet Agent language information file 
L] gwwww1.d11 Customized DLL program for MIME 
_] x*10a.dl1l XIS DLL programs 
_] gwxis10.d11 GroupWise XIS DLL program 
_] gwia.xml XIS agent configuration file 


See also Section 7.5, “Internet Agent Queue Directory,” on page 83. 


c:\Program Files\Novell\GroupWise Server\GWIA 


On a Windows server, the Internet Agent can be installed in any directory you choose. The default 
location is c:\Program Files\Novell\GroupWise Server\GWIA. The Internet Agent icon is set up 
to include the full path to whatever directory you choose. 


gwenv1a.dll file 


The gwenvla.d11 file is the GroupWise Agent Engine, a program that is shared by both GroupWise 
agents. It provides the following services to the agents: 

+ Database management 

+ File operations 

+ Message handling 

+ Thread management 

+ Semaphores (file/record locking) 


+ Date/time services 


The first agent started on a server automatically starts the GroupWise Agent Engine DLL. 


gwia.exe file 
The gwia. exe file is the Internet Agent program. You run this executable file to start the Internet 


Agent. See “Starting the Internet Agent” in “Installing the GroupWise Internet Agent” in the 
GroupWise 8 Installation Guide. 


gwia.cfg file 


On Windows, the gwia.cfg file in the installation directory is simply a pointer to the gwia.cfg file 
under the domain directory where the actual Internet Agent configuration file is located. 
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8.3 


8.3.1 


gwianxx.chm file 


The .chm files contain the online documentation for the Internet Agent. Online help is available by 
clicking Help in the Internet Agent console on the server where the agent is running. In addition, 


dialog boxes have a Help button for context-sensitive Help. 


The digit n is a version number. The last two characters xx are a language code. 


gwianxx.dll files 


The gwianxx.d11 files contain all language-specific information for the Internet Agent. The digit n is 


a version number. The last two characters xx are a language code. 


gwwww1.dil file 


The gwwww1 .d11 file provides parsing of MIME messages received from the Internet. 


x*10a.dll and gwxis10.dll files 


The x*10a.d11 and gwxis10.d11 programs provide XIS capability for the GroupWise agents, so 
that you can create XML documents to monitor and change the agents as needed. 


gwia.xml file 


The gwia.xml file is a specialized agent configuration file for use in the XIS environment. 


WebAccess Agent Installation 


+ Section 8.3.1, “NetWare Installation Directory,” on page 117 
+ Section 8.3.2, “Linux Installation Directory,” on page 120 


+ Section 8.3.3, “Windows Installation Directory,” on page 123 


+ Section 8.3.4, “Document Viewer Agent Working Directory,” on page 126 


NetWare Installation Directory 


E sys: system NetWare WebAccess Agent installation directory 
_] gwenn5 .nlm GroupWise 8 Agent Engine 
_] gwinter.nlm WebAccess Agent program 
_] gwdva.nim Document Viewer Agent program 
_] strtweb.ncf WebAccess Agent load file 
_] stopweb.ncf WebAccess Agent unload file 
_] webac80a.waa WebAccess Agent startup file 
_] gwdva.dva Document Viewer Agent startup file 
_] x*5.nlm XIS NLM programs 
_] gwxis12.n1m GroupWise XIS NLM program 
_] gwinter.xml WebAccess Agent XIS configuration file 
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E cache Subdirectory for WebAccess template file storage 
el template\xx Subdirectory for HTML template files 
_] webacc.tpt WebAccess template files 
_] publish.tpt WebPublisher template files 


el gwdva.dir Document Viewer Agent working directory 
el help Subdirectory for GroupWise agent console help files 


Additional WebAccess files are integrated into your Web server to support the WebAccess client and 
the WebAccess Agent Web console. See Section 9, “Web Application Installation Directories on Your 
Web Server,” on page 133. See also Section 7.4, “WebAccess Agent Queue Directory,” on page 81. 


NetWare WebAccess Agent installation directory 


On a NetWare server, the GroupWise WebAccess Agent is typically installed in the sys: system 
directory. You can choose a different location during installation. 


gwenn5.nim file 


The gwenn5 .n1m file is the GroupWise 8 Agent Engine, a program that is shared by all GroupWise 
agents. It provides the following services to the agents: 


+ Database management 

+ File operations 

+ Message handling 

+ Thread management 

+ Semaphores (file/record locking) 


+ Date/time services 


The first agent loaded on a server automatically loads the GroupWise Agent Engine. 


gwinter.nlm file 


The gwinter.n1m file is the WebAccess Agent program. 


gwdva.nim file 


The gwdva .n1m file is the Document Viewer Agent program. 


strtweb.ncf file 


The strtweb.ncf file is the NetWare configuration file that automatically loads the WebAccess 
Agent whenever the server is restarted. A typical strtweb .ncf file would look similar to the 
following: 


load sys:\system\gwinter @webac80a.waa 


It includes the WebAccess Agent startup file in the load command. For more information, see 
“Starting GroupWise WebAccess” in “Installing GroupWise WebAccess” in the GroupWise 8 
Installation Guide. 
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stopweb.ncf 


The stopweb.ncf file is the NetWare configuration file that unloads the WebAccess Agent. A typical 
stopweb.ncf file would look similar to the following: 


unload gwinter 


webac80a.waa file 
The WebAccess Agent startup file contains startup switches for the WebAccess Agent. Switch settings 
placed in the WebAccess Agent startup file override comparable options set for the WebAccess Agent 


in ConsoleOne. The startup file is named the same as the WebAccess Agent object in ConsoleOne. 
The default is webac80a. 


During installation, a customized version of the WebAccess Agent startup file is created. This 
customized version has the /home startup switch automatically set to the domain directory where the 
WebAccess Agent's queue directories are located. See “Using WebAccess Startup Switches” in 
“WebAccess” in the GroupWise 8 Administration Guide. 


gwdva.dva file 
The gwdva . dva file is the Document Viewer Agent startup file. The Viewer Agent is currently 


configured completely by startup switches. For more information, see “Document Viewer Agent 
Startup Switches”. 


x*5.nlm and gwxis12.nlm files 


The x*5.nlmand gwxis12.n1m programs provide XIS capability for the GroupWise agents, so that 
you can create XML documents to monitor and change the agents as needed. 


gwinter.xml file 


The gwinter.xml file is a specialized WebAccess Agent configuration file for use in the XIS 
environment. 


cacheltemplatelxx directory 


The cache* template! xx directory holds language-specific HTML template files that the WebAccess 
Agent passes to the Document Viewer Agent for viewing documents in documents in WebAccess 
and WebPublisher. The xx is a two-letter language code. 


gwdva.dir directory 


See Section 8.3.4, “Document Viewer Agent Working Directory,” on page 126. 


help directory 


The help directory holds help files and images used by the WebAccess Agent Web console. See 
“Using the WebAccess Agent Web Console” in “WebAccess” in the GroupWise 8 Administration Guide. 
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8.3.2 


E /opt/novell/groupwise 


j agents 
@ bin 
_] gwinter 
_] gwinter.xml 


Jj webac80axx.waa 


E] template 


_] gwdva 
E gwdva.dir 


[| share 
_] webac80a.waa 
B gwdva.dva 


EN] webcon 
E help 


MN /etc/init.d 
J grpwise 
MN rc3.d 
_] Snngrpwise 


Mi rcs.d 
L Snngrpwise 


EN /var/log/ 


HH] novell/groupwise 


[| domain.webac80a 
M000. pre 


_] mmddgwia.nnn 


ES gwdva 
Jj mmdddva . nnn 


Linux Installation Directory 


Novell GroupWise installation directory 
Linux agent installation directory 


Subdirectory for GroupWise agent executables 
WebAccess Agent executable 

WebAccess Agent XIS configuration file 
Boilerplate WebAccess startup file 
Subdirectory for HTML template files 


Document Viewer Agent executable 
Document Viewer Agent working directory 


Subdirectory for GroupWise agent library files 
Supporting shared library files 


Subdirectory for icon images 


Subdirectory for agent shared files 
WebAccess Agent startup file 
Document Viewer Agent startup file 


Subdirectory for agent Web console files 
Subdirectory for agent Web console help files 


Standard Linux location for application startup scripts 
Startup script for the WebAccess Agent 


Standard Linux location for run-level-3 symbolic links 
Symbolic link to the startup script for the WebAccess Agent 


Standard Linux location for run-level-5 symbolic links 
Symbolic link to the startup script for the WebAccess Agent 


Standard Linux location for application log files 
Subdirectory for GroupWise agent log files 


Domain-specific subdirectory for WebAccess Agent log files 
Processing directory for log files 
WebAccess Agent log files 


Subdirectory for Viewer Agent log files 
Viewer Agent log files 


Additional WebAccess files are integrated into your Web server to support the WebAccess client and 
the WebAccess Agent Web console. See Section 9, “Web Application Installation Directories on Your 
Web Server,” on page 133. See also Section 7.4, “WebAccess Agent Queue Directory,” on page 81. 
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agents directory 


On a Linux server, the WebAccess Agent is always installed in subdirectories of /opt /novel1/ 
groupwise/agents. 


bin directory 


The bin directory holds GroupWise executable files. 


gwinter file 


The gwinter file is the WebAccess Agent executable. You run this executable file to start the 
WebAccess Agent. See “Linux: Setting Up GroupWise WebAccess” in “Installing GroupWise 
WebAccess” in the GroupWise 8 Installation Guide. 


gwinter.xml file 


The gwinter.xml file is a specialized configuration file for use in the XIS environment. 


webac80axx.waa file 


The webac80axx.waa file is the boilerplate file from which a domain-specific webac80a.waa file is 
created in the share directory. The webac80a represents the name of the WebAccess Agent object in 
eDirectory. The xx represents a two-letter language code. 


templatelxx directory 


The template! xx directory holds language-specific HTML template files that the WebAccess Agent 
passes to the Document Viewer Agent for viewing documents in WebAccess and WebPublisher. The 
xx is a two-letter language code. 


gwdva file 


The gwdva file is the Document Viewer Agent executable. The WebAccess Agent starts and stops the 
Viewer Agent automatically whenever it starts and stops. 


gwdva.dir directory 


See Section 8.3.4, “Document Viewer Agent Working Directory,” on page 126. 


lib directory 


The lib directory holds GroupWise shared library files. 


* so files 


The * . so files are Linux shared library files that provide information to the WebAccess Agent 
executable. 


image directory 


The image directory has subdirectories for agent icons for both color and monochrome displays. 
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share directory 


The share directory holds agent startup files and files that are used by the agent consoles and Web 
consoles. 


webac80a.waa file 


The WebAccess Agent startup file contains startup switches for the WebAccess Agent. Switch settings 
placed in the WebAccess Agent startup file override comparable options set for the WebAccess Agent 
in ConsoleOne. The startup file is named the same as the WebAccess Agent object in ConsoleOne. 
The default is webac80a. 


During installation, a customized version of the WebAccess Agent startup file is created. This 
customized version has the /home startup switch automatically set to the domain directory where the 
WebAccess Agent's queue directories are located. See “Using WebAccess Startup Switches” in 
“WebAccess” in the GroupWise 8 Administration Guide. 


gwdva.dva file 


The gwdva . dva file is the Document Viewer Agent startup file. The Viewer Agent is currently 
configured completely by startup switches. For more information, see “Document Viewer Agent 
Startup Switches”. 


webcon directory 


The webcon directory holds subdirectories and files used by the agent Web consoles, such as help 
files. 


letclinit.d directory 


The /etc/init .d directory is the standard location for Linux startup scripts. 


grpwise file 


The grpwi se script is created automatically during installation. You can use the script to start, restart, 
stop, and display status information about the WebAccess Agent. For more information about 
starting the WebAccess Agent, see “Linux: Setting Up GroupWise WebAccess” in “Installing 
GroupWise WebAccess” in the GroupWise 8 Installation Guide. 


rc3.d directory 


The rc3 .d directory holds symbolic links to scripts that you want your Linux server to run when it is 
booted to runlevel 3 (multi-user; boots to a text mode login prompt without the X Window System). 
The symbolic link to the grpwise script is Snngrpwise. It is created if you choose during installation 
to have the WebAccess Agent start automatically when the server boots. 


rc5.d directory 


The rc5 .d directory holds symbolic links to scripts that you want your Linux server to run when it is 
booted to runlevel 5 (multi-user; boots to the X Window System login dialog box). The symbolic link 
to the grpwise script is Snngrpwise. It is created if you choose during installation to have the 
WebAccess Agent start automatically when the server boots. 
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8.3.3 


Ivarllog/novell/groupwise directory 


domain.webac80a directory 


gwdva directory 


Windows Installation Directory 


Ea c:\Program Files\Novell\GroupWise 


Server\WebAccess 


O gwenvla.dll 
_] gwinter.exe 
_] strtweb.bat 
_] webac80a.waa 


_] gwdva.exe 
LJ gwdva.dva 
el gwdva.dir 


L gwwanxx.dll 
_] gwwasnmp.dl1 
Ll gwwww1.dll 


L]x*10a.d11 
_] gwxis10.d11 
LJ gwinter.xml 


E] cache\template\xx 
_j webacc.tpt 
_] publish.tpt 


E] help 


The domain. webac80a directory is a domain-specific location for WebAccess Agent log files. 


000.pre directory Within the 000 . prc directory, the WebAccess Agent creates log files 
(mmddweb . nnn) to inform you of its processing and any problems it encounters. For more information 
about log files, see “Controlling WebAccess Agent Logging” in “WebAccess” in the GroupWise 8 

Administration Guide. 


Windows WebAccess Agent installation directory 


GroupWise Agent Engine 
WebAccess Agent program 
WebAccess Agent batch file 
WebAccess Agent startup file 


Document Viewer Agent program 
Document Viewer Agent startup file 
Document Viewer Agent working directory 


WebAccess Agent language information file 
Customized DLL program for SNMP 
Customized DLL program for MIME 


XIS DLL programs 
GroupWise XIS DLL program 
WebAccess Agent XIS configuration file 


Subdirectory for HTML template files 
WebAccess template files 
WebPublisher template files 


Subdirectory for GroupWise agent console help files 
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The /var/1log directory is the standard location for log files on Linux. All GroupWise agent log files 
are created in the novell/groupwise subdirectory. 


The first two digits of the filename represent the month; the next two digits represent the day of the 
month. The three-digit extension is a sequence number for multiple log files created on the same day. 
For example, 0518web. 002 is the second WebAccess Agent log file created on May 18. 


The gwdva directory stores Viewer Agent log files. The first two digits of the filename represent the 
month, the next two digits represent the day of the month. The three-digit extension is a sequence 
number for multiple log files created on the same day. For example, 0518web. 002 is the second 
Viewer Agent log file created on May 18. 
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Additional WebAccess files are integrated into your Web server to support the WebAccess client and 
the WebAccess Agent Web console. See Section 9, “Web Application Installation Directories on Your 
Web Server,” on page 133. See also Section 7.4, “WebAccess Agent Queue Directory,” on page 81. 


c:\Program Files\Novell\GroupWise Server\WebAccess 


On a Windows server, the WebAccess Agent can be installed in any directory you choose. The default 
location is c:\Program Files\Novell\GroupWise Server\WebAccess. The WebAccess Agent 
desktop icon is set up to include the full path to whatever directory you choose. 


gwenv1a.dll file 


The gwenvia.d11 file is the GroupWise Agent Engine, a program that is shared by all GroupWise 
agents. It provides the following services to the agents: 

+ Database management 

+ File operations 

+ Message handling 

+ Thread management 

+ Semaphores (file/record locking) 


+ Date/time services 


The first agent started on a server automatically starts the GroupWise Agent Engine DLL. 


gwinter.exe file 


The gwinter.exe file is the WebAccess Agent program. 


strtweb.bat file 


The strtweb.bat file is used to start the WebAccess Agent. The batch file specifies the WebAccess 
startup file. A typical strtweb.bat file includes the following: 


title Novell GroupWise WebAccess @echo off cls gwinter.exe @webac80a.waa 


You run this batch file to start the WebAccess Agent. See “Starting GroupWise WebAccess” in 
“Installing GroupWise WebAccess” in the GroupWise 8 Installation Guide. 


webac80a.waa file 


The WebAccess Agent startup file contains startup switches for the WebAccess Agent. Switch settings 
placed in the WebAccess Agent startup file override comparable configuration options set for the 
WebAccess Agent in ConsoleOne. The startup file is named the same as the WebAccess Agent object 
in eDirectory. The default is webac80a. 


During installation, the WebAccess Agent startup file is created with the /home startup switch 
automatically set to the domain directory where the WebAccess Agent queue directory 
(domain\wpgate\ webac8 0a) is located. See “Using WebAccess Startup Switches” in “WebAccess” in 
the GroupWise 8 Administration Guide. 
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gwdva.exe file 


The gwdva . exe file is the Document Viewer Agent program. The WebAccess Agent automatically 
starts and stops the Viewer Agent whenever the WebAccess Agent starts and stops. 


gwdva.dva file 


The gwdva . dva file is the Document Viewer Agent startup file. The Viewer Agent is currently 
configured completely by startup switches. See “Document Viewer Agent Startup Switches”. 


gwdva.dir directory 


See Section 8.3.4, “Document Viewer Agent Working Directory,” on page 126. 


gwwanxx.dll files 


The gwwanxx.d11 files contain all language-specific information for the WebAccess Agent. The digit 
n is a version number. The last two characters xx are a language code. 


gwwasnmp.dll file 
The gwwasnmp.d11 file provides interaction with the Windows SN MP Service, so that you can 
monitor the WebAccess Agent using an SNMP monitoring program. This file is not installed unless 


you enable SNMP during installation. It cannot be installed if the SNMP Service is not installed on 
the Windows server. 


gwwww1.dil file 


The gwwww1 .d11 file provides parsing of MIME messages received from the Internet. 


x*10a.dll and gwxis10.dll files 


The x*10a.d11 and gwxis10.d11 programs provide XIS capability for the GroupWise agents, so that 
you can create XML documents to monitor and change the agents as needed. 


gwinter.xml file 


The gwia.xml file is a specialized agent configuration file for use in the XIS environment. 


cacheltemplatelxx directory 
The cache\template\xx directory holds language-specific HTML template files that the WebAccess 


Agent passes to the Document Viewer Agent for viewing documents in WebAccess and 
WebPublisher. The xx is a two-letter language code. 


help directory 


The help directory holds help files and images used by the WebAccess Agent Web console. See 
“Using the WebAccess Agent Web Console” in “WebAccess” in the GroupWise 8 Administration Guide. 
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8.3.4 Document Viewer Agent Working Directory 


The Document Viewer Agent creates its working directory as a subdirectory of its installation 
directory. The default location varies by platform: 

NetWare: sys:\system\gwdva.dir 

Linux: /opt/novell/groupwise/agents/bin/gwdva.dir 


Windows: c:\Program Files\Novell\GroupWise Server\WebAccess\gwdva.dir 


E] gwdva.dir Document Viewer Agent working directory 
J gwdavnnn. ste State files for Document Viewer Agent worker threads 
E cache Subdirectory for caching converted documents for repeated display 
Š 000 Subdirectory for converted GroupWise library documents 
HN] tran Subdirectory for converted attachment documents 
E] problem Subdirectory for information about documents that failed conversion 
@ hold Subdirectory for quarantined documents that failed HTML conversion 
al log Subdirectory for Document Viewer Agent log files 
El temp Subdirectory for the temporary files using during HTML conversion 
HA] template (not currently used) 


gwdva.dir directory 


The gwdva . dir directory is the working directory for the Document Viewer Agent. 


gwdvannn.ste files 


The gwdvannn. ste files hold state information about each Document Viewer Agent worker thread. 
To control the number of worker threads, see “Agent Performance” in “Configuring the Document 
Viewer Agent” in the GroupWise 8 Administration Guide. 


cache directory 


The cache directory contains subdirectories for managing the documents that the Viewer Agent has 
already converted. See “Document Cache” in “WebAccess” in the GroupWise 8 Administration Guide. 


000 directory 


The 000 directory holds GroupWise library documents that have been converted to HTML. Because 
these documents belong to a GroupWise library, they are retained for a longer period of time. If the 
documents in the 000 directory exceed the established maximum cache size, a new directory, 001, is 
created. Additional library cache directories are created as needed. 


tran directory 


The tran directory holds attachment documents that have been converted to HTML. Attached 
documents are more transitory than GroupWise library documents and are retained for a shorter 
period of time. 
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problem directory 
The problem directory stores information about documents that have failed conversion. This 
prevents the Viewer Agent from needlessly attempting to convert the same failed documents. 


hold directory 


The hold directory is the document quarantine directory. Here the Viewer Agent places documents 
that have failed HTML conversion. You can configure the Viewer Agent to notify an administrator 
when a document fails conversion. See “Document Quarantine” in “WebAccess” in the GroupWise 8 
Administration Guide 


log directory 


The log directory stores log files produced by the Viewer Agent. See “Agent Log Files” in 
“WebAccess” in the GroupWise 8 Administration Guide. 





NOTE: On Linux, Viewer Agent log files are stored in the typical location for log files on Linux (/ 
var/log/novell/groupwise/gwdva), rather than under the gwdva . dir directory. 


temp directory 


The temp directory is used for the temporary files created during HTML conversion. See “Document 
Conversion” in “WebAccess” in the GroupWise 8 Administration Guide. 


8.4 Monitor Agent Installation 


¢ Section 8.4.1, “Linux Installation Directory,” on page 127 


+ Section 8.4.2, “Windows Installation Directory,” on page 129 


8.4.1 Linux Installation Directory 


E /opt/novell/groupwise GroupWise installation directory 


E] agents Linux agent installation directory 
@ bin Subdirectory for GroupWise agent executables 
_] gwmon Monitor Agent executable 
MN lib Subdirectory for GroupWise agent library files 
LÌ *.so Supporting shared library files 
HH] share Subdirectory for agent shared files 
_] monitor.xml Monitor Agent configuration file 
MN /etc/init.d Standard Linux location for application startup scripts 
_] grpwise-ma Startup script for the Monitor Agent 
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HH] rc3.d Standard Linux location for run-level-3 symbolic links 


_] snngrpwise-ma Symbolic link to the startup script for the Monitor Agent 
MM rc5.d Standard Linux location for run-level-5 symbolic links 
_] snngrpwise-ma Symbolic link to the startup script for the Monitor Agent 
[| /var/log/ Standard Linux location for application log files 
el novell/groupwise Subdirectory for GroupWise agent log files 
el gwmon Subdirectory for Monitor Agent log files 
_] mmddmon. nnn Monitor Agent event log files 
_] mmddhist . nnn Monitor Agent history log files 
EN] acct Subdirectory for Monitor Agent accounting files 


agents directory 


On a Linux server, the Monitor Agent is always installed in subdirectories of /opt/nove11/ 
groupwise/agents. 


bin directory 


The bin directory holds GroupWise executable files. 


gwmon file 


The gwmon file is the Monitor Agent executable. You run this executable file to start the Monitor 
Agent. See “Starting the Linux Monitor Agent as a Daemon” in “Installing GroupWise Monitor” in 
the GroupWise 8 Installation Guide. 


lib directory 


The 1ib directory holds GroupWise shared library files. 


* so files 


These files are Linux shared library files that provide information to the Monitor Agent executable. 


share directory 


The share directory holds agent startup files and files that are used by the agent consoles and Web 
consoles. 


monitor.xml file 


The monitor.xml file is a specialized configuration file for use in the XIS environment. 


letclinit.d directory 


The /etc/init .d directory is the standard location for Linux startup scripts. 
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8.4.2 


grpwise-ma file 


The grpwise-ma script is created automatically during installation. You can use the script to start, 
restart, stop, and display status information about the Monitor Agent. For more information about 
starting the Monitor Agent, see “Starting the Linux Monitor Agent as a Daemon” in “Installing 
GroupWise Monitor” in the GroupWise 8 Installation Guide. 


rc3.d directory 


The rc3 .d directory holds symbolic links to scripts that you want your Linux server to run when it is 
booted to runlevel 3 (multi-user; boots to a text mode login prompt without the X Window System). 
The symbolic link to the grpwise-ma script is Snngrpwise-ma. It is created if you choose during 
installation to have the Monitor Agent start automatically when the server boots. 


rc5.d directory 


The rc5 .d directory holds symbolic links to scripts that you want your Linux server to run when it is 
booted to runlevel 5 (multi-user; boots to the X Window System login dialog box). The symbolic link 
to the grpwise-ma script is Snngrpwise-ma. It is created if you choose during installation to have the 
Monitor Agent start automatically when the server boots. 


Ivarllog/novell/groupwise directory 


The /var/1log directory is the standard location for log files on Linux. All GroupWise agent log files 
are created in the novell /groupwise subdirectory. 


gwmon directory 


Within the gwmon directory, the Monitor Agent creates two different types of log files. The 
mmddmon.nnn log files inform you of its processing and any problems it encounters. The 
mmddhist.nnn log files record dumps of all MIB values gathered during each poll cycle. For more 
information about log files, see “Configuring Monitor Agent Log Settings” in “Monitor” in the 
GroupWise 8 Administration Guide. 


The first two digits of the filename represent the month; the next two digits represent the day of the 
month. The three-digit extension is a sequence number for multiple log files created on the same day. 
For example, 0518mon. 002 is the second Monitor Agent log file created on May 18. 


gwmon/acct directory 


Within the gwmon directory, the Monitor Agent creates an acct subdirectory for storing accounting 
files received from the Internet Agent and GroupWise gateways. For more information, see 
“Receiving the Accounting Files” in “Monitor” in the GroupWise 8 Administration Guide. 


Windows Installation Directory 


HA c:\Program Files\Novell\GroupWise Windows Monitor Agent installation directory 
Server\Monitor 


_] gwenvia.dll GroupWise Agent Engine 
_] gwmon. exe Monitor Agent program 
_] monitor.xml Monitor Agent configuration file 
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_] gwmonxx.d11 Monitor Agent language information file 


_] gwsnmp.d11 Customized DLL program for SNMP 

_] x*10a.dl11 XIS DLL programs 

O gwxis10.dll GroupWise XIS DLL program 

_] gwmon. xml Monitor Agent XIS configuration file 

T monwork Monitor Agent working directory 

MN acct Monitor Agent directory for accounting files 


Additional Monitor files are integrated into your Web server to support the Monitor Web console. For 
an example, see Section 9, “Web Application Installation Directories on Your Web Server,” on 
page 133. 


c:\Program Files\Novell\GroupWise Server\Monitor directory 


On a Windows server, the Monitor Agent can be installed in any directory you choose. The default 
location is c:\Program Files\Novell\GroupWise Server\Monitor. The Monitor Agent desktop 
icon is set up to include the full path to whatever directory you choose. 


gwenv1a.dll file 


The gwenvia.d11 file is the GroupWise Agent Engine, a program that is shared by all GroupWise 
agents. It provides the following services to the agents: 

+ Database management 

¢ File operations 

+ Message handling 

+ Thread management 

+ Semaphores (file/record locking) 


+ Date/time services 


The first agent started on a server automatically starts the GroupWise Agent Engine DLL. 


gwmon.exe file 
The gwmon.. exe file is the Monitor Agent program. You run this executable file to start the Monitor 


Agent. See “Windows: Setting Up GroupWise Monitor” in “Installing GroupWise Monitor” in the 
GroupWise 8 Installation Guide. 


monitor.xml 
The monitor.xml file stores the Monitor Agent configuration information that you establish in the 


Monitor Agent console, as described in “Configuring the Monitor Agent” in “Monitor” in the 
GroupWise 8 Administration Guide. 


gwmonxx.dll files 


The gwmonxx. d11 files contain all language-specific information for the WebAccess Agent. The last 
two characters xx are a language code. 
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gwsnmp.dll file 
The gwsnmp .d11 file provides interaction with the Windows SNMP Service, so that the Monitor 


Agent can throw SNMP traps. See “Configuring SNMP Trap Notification for Agent Problems” in 
“Monitor” in the GroupWise 8 Administration Guide. 


x*10a.dll and gwxis10.dll files 


The x*10a.d11 and gwxis10.d11 programs provide XIS capability for the GroupWise agents, so 
that you can create XML documents to monitor and change the agents as needed. 


gwmon.xml file 


The gwmon .xml file is a specialized agent configuration file for use in the XIS environment. 


monwork directory 


The monwork directory is used for temporary files used in calculating system performance, as 
described in “Measuring Agent Performance” in “Monitor” in the GroupWise 8 Administration Guide 


acct directory 
The acct directory is used for storing accounting files received from the Internet Agent and 


GroupWise gateways, as described in “Receiving the Accounting Files” in “Monitor” in the 
GroupWise 8 Administration Guide. 
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9.1 


Web Application Installation Directories 
on Your Web Server 


WebAccess, WebPublisher, and Monitor rely on the presence of a Web server in order to fulfil their 
functions. A number of Web servers are supported. See “GroupWise System Requirements” in 
“Installing a Basic GroupWise System” in the GroupWise 8 Installation Guide. 


On Linux, the GroupWise Web applications are installed into the Apache Web server and the Tomcat 
Java Servlet Container. On Windows, the GroupWise Web applications are installed into the Internet 
Information Server (IIS) and the Tomcat Java Servlet Container. On both platforms, configuration 
files, log files, and working files, are stored in a separate directory outside of your Web server and 
Tomcat installations. 

+ Section 9.1, “NetWare Apache/Tomcat Installation Directories,” on page 133 

+ Section 9.2, “OES 11 Apache/Tomcat Installation Directories,” on page 139 

+ Section 9.3, “OES 2 Linux Apache/Tomcat Installation Directories,” on page 141 

+ Section 9.4, “SLES 11 Apache/Tomcat Installation Directories,” on page 144 

+ Section 9.5, “SLES 10 Apache/Tomcat Installation Directories,” on page 146 

+ Section 9.6, “Windows IIS/Tomcat Installation Directories,” on page 149 


+ Section 9.7, “GroupWise Web Application Working Directory,” on page 153 


NetWare Apache/Tomcat Installation Directories 


E sys :lapache2 Apache installation directory 
BN conf Standard Apache directory 
_] httpd.conf Main Apache configuration file 
_] GWApache2.conf Apache configuration file for GroupWise WebAccess 
_] gwmon. conf Apache configuration file for GroupWise Monitor 
_] gweal.conf Apache configuration file for the GroupWise Calendar Publishing 
Host 
E htdocs Apache document root directory 
_] index.html Web server default Web page 
En] sys:\tomcat\4 Tomcat installation directory 
HA] webapps/gw GroupWise-specific document root directory 
_] index.html GroupWise-specific Web services page 
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E com/novell/webaccess 
E com/novell/webpublisher 


=| webaccess 
el webpublisher 


E] WEB- INF 
J web.xml 


[| classes/com/novell 


em 


| webaccess 
ES] providers 


al webpublisher 
En] providers 


ZA] classes/templates 


E] webapps/gwcal 
_] index.html 


ZE] WEB-INF 
LJ web.xml 


el webapps/gwmon 
_] index.html 


| WEB- INF 
J web.xml 


E] classes/templates 


A] sys: \Novell\GroupWise 


HH] calhost 
J calhost cig 
EN] logs 


Es] gwmonitor 
O gwmonitor.cfg 
fel logs 


HA] webaccess 
Lj webacc.cfg 
O commgr .cfg 
ldap.cfg 
el logs 
@ users 

E webpubl isher 
_] webpub.cfg 


L commgr .cfg 
E logs 


Directory for WebAccess help files 
Directory for WebPUblisher help files 


Directory for GroupWise WebAccess Application files 
Directory for GroupWise WebPublisher Application files 


GroupWise Web service information directory 
GroupWise Web service configuration file 


Directory for Novell product files 


Directory for GroupWise WebAccess files 
Subdirectory for service provider files 


Directory for GroupWise WebPublisher files 
Subdirectory for service provider files 


GroupWise Web service template files 


Calendar Publishing Host document root directory 
Calendar Publishing Host Web services page 


Calendar Publishing Host Web service information directory 


Calendar Publishing Host Web service configuration file 


GroupWise Monitor document root directory 
GroupWise Monitor Web services page 


GroupWise Monitor Web service information directory 
GroupWise Monitor Web service configuration file 


GroupWise Monitor Web service template files 


Directory for GroupWise Web services files 


Subdirectory for the Calendar Publishing Host 
Calendar Publishing Host configuration file 
Directory for Calendar Publishing Host log files 


Subdirectory for GroupWise Monitor 
Monitor Application configuration file 
Directory for Monitor Application log files 


Subdirectory for WebAccess 

WebAccess Application configuration file 
Communications Manager configuration file 
LDAP service provider configuration file 
Directory for WebAccess Application log files 
Directory for WebAccess users’ session files 


Subdirectory for WebAccess Application files 
WebPublisher Application configuration file 
Communications Manager configuration file 
Subdirectory for WebPublisher Application log files 
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9.1.1  sys:lapache2/conf directory 


The /apache2/conf directory is the standard Apache Web server configuration directory. 


httpd.conf file 


The httpd. conf file is the main Apache configuration file. On NetWare, the GroupWise Installation 
program modifies it to include a reference to the GWApache2. conf file. 


GWApache2.conf file 


The GWApache2 . conf file includes the JkMount command that enables Apache to access the 
GroupWise WebAccess and WebPublisher application files that have been installed into Tomcat. 


gwmon.conf file 


The gwmon.. conf file includes the JkMount command that enables Apache to access the GroupWise 
Monitor application files that have been installed into Tomcat. 


gwcal.conf file 


The gwcal . conf file includes the JkMount command that enables Apache to access the GroupWise 
Calendar Publishing Host application files that have been installed into Tomcat. 


htdocs/index.html file 
The index.html file in the htdocs directory is the default HTML file that displays in your Web 


browser when you go to the IP address or hostname of the server. 


9.1.2  sys:ltomcatl4lwebapps 


The /tomcat /4/webapps directory is where applications are installed into the Web server. 


gwiindex.html file 


The index.html file in the gw directory is the default HTML file for the GroupWise client Web 
services (WebAccess and WebPublisher) and displays when you go to the following URL: 


http://web_server_address/gw 
From this default page, WebAccess and WebPublisher URLs can be easily accessed: 


http://web_server_address/gw/webacc 
http://web_server_address/gw/webpub 


gwIWEB-INF/web.xml file 


The web. xml file tells the Web server where the various GroupWise service providers and their 
configuration files are located. By default, they are located in subdirectories under 
sys: \Novell\GroupWise. 
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gw/WEB-INFiclasses/com/novelliwebaccess/providers directory 
The providers directory holds the Java class and properties files for the WebAccess providers. For 


more information, see “Adding or Removing Service Providers” in “WebAccess” in the GroupWise 8 
Administration Guide. 


gw/WEB-INFiclasses/com/novelliwebpublisher/providers directory 
The providers directory holds the Java class and properties files for the WebPublisher providers. For 


more information, see “Adding or Removing Service Providers” in “WebAccess” in the GroupWise 8 
Administration Guide. 


gw/WEB-INFiclasses/templates directory 
The templates directory holds subdirectories for the various file formats used in various browser 


environments. For more information, see “Modifying WebAccess Application Template Settings” in 
“WebAccess” in the GroupWise 8 Administration Guide. 


gwcal/index.html file 


The index.html file in the gwcal directory is the default HTML file for the GroupWise Calendar 
Publishing Host Web service and displays when you go to the following URL: 


http://web_server_address/gwcal 


gwcal/WEB-INF/web.xml file 


The web.xml file tells the Web server where the Calendar Publishing Host service provider and its 
configuration file are located. 


gwmon/index.html file 


The index.html file in the gwmon directory is the default HTML file for the GroupWise Monitor Web 
service and displays when you go to the following URL: 


http://web_server_address/gwmon 


gwmon/WEB-INF/web.xml file 


The web.xml file tells the Web server where the GroupWise Monitor service provider and its 
configuration file are located. 


gwmon/WEB-INFiclasses/templates directory 


The templates directory holds subdirectories for the various file formats used in various browser 
environments. For more information, see “Modifying Monitor Application Template Settings” in 
“Monitor” in the GroupWise 8 Administration Guide. 


9.1.3 sys:\Novell\GroupWise directory 


The sys: \Novell\GroupWise directory holds subdirectories for each GroupWise application. 
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9.1.4 


9.1.5 


9.1.6 


calhost directory 


The calhost directory is created when you install the Calendar Publishing Host. 


calhost.cfg file 
The calhost.cfg file holds Calendar Publishing Host configuration information. For more information, 


see “Configuring the Calendar Publishing Host” in “Calendar Publishing Host” in the GroupWise 8 
Administration Guide. 


logs directory 
The logs subdirectory holds Calendar Publishing Host Application log files. For more information, 


see “Using Calendar Publishing Host Log Files” in “Calendar Publishing Host” in the GroupWise 8 
Administration Guide. 


gwmonitor directory 


The gwmonitor directory is created when you install GroupWise Monitor. 


gwmonitor.cfg file 
The gwmonitor.cfg file holds the same configuration information that is stored on the Monitor 


Application object (named GroupWiseMonitor) in eDirectory. For more information, see 
“Configuring the Monitor Application” in “Monitor” in the GroupWise 8 Administration Guide. 


logs directory 


The logs subdirectory holds Monitor Application log files. For more information, see “Modifying 
Monitor Application Log Settings” in “Monitor” in the GroupWise 8 Administration Guide. 


webaccess directory 


The webaccess directory holds files used by the WebAccess Application. 


webacc.cfg file 
The webacc . cfg file holds the same configuration information that is stored on the WebAccess 


Application object (named GroupWiseWebAccess) in eDirectory. For more information, see 
“Configuring the WebAccess Application” in “WebAccess” in the GroupWise 8 Administration Guide. 


commgr.cfg file 
The commgr . cfg file holds the same configuration information that is stored on the GroupWise 


Provider object (named GroupWiseProvider) in eDirectory, including the IP address, port number, 
number of threads, and encryption key for the WebAccess Agent. This information enables the 
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WebAccess Application to communicate with the WebAccess Agent. For more information, see 
“Configuring the GroupWise Service Provider” in “WebAccess” in the GroupWise 8 Administration 
Guide. 


A copy of the commgr . cfg file is automatically maintained in the WebAccess Agent queue directory 
(domain\wpgate\webac80a). 


Idap.cfg file 


The ldap.cfg file holds the same configuration information that is stored on the LDAP Provider 
object (named LDAPProvider) in eDirectory. For more information, see “Configuring the LDAP 
Service Provider” in “WebAccess” in the GroupWise 8 Administration Guide. 


logs directory 


The logs subdirectory holds WebAccess Application log files. For more information, see 
“Controlling WebAccess Application Logging” in “WebAccess” in the GroupWise 8 Administration 
Guide. 


users directory 


The users subdirectory holds session files for WebAccess users. If WebAccess times out after a 
period of user inactivity, the user’s session information is saved. When the user logs back in, the 
session information is retrieved so that the user can continue working without loss of data. Also, 
users’ message text is saved during each session, so that if the WebAccess Application is restarted or 
goes down, users do not lose the message text they were composing at the time. 


9.1.7 webpublisher directory 


The webpublisher directory holds files used by the WebPublisher Application. 


webpub.cfg 


The webpub . cfg file holds the same configuration information that is stored on the WebPublisher 
Application object (named GroupWiseWebPublisher) in eDirectory. For more information, see 
“Configuring the WebPublisher Application” in “WebAccess” in the GroupWise 8 Administration 
Guide. 


commgr.cfg file 


The commgr . cfg file holds the same configuration information that is stored on the GroupWise 
Provider object (named GroupWiseProvider) in eDirectory, including the IP address, port number, 
number of threads, and encryption key for the WebAccess Agent. This information enables the 
WebAccess Application to communicate with the WebAccess Agent. For more information, see 
“Configuring the GroupWise Service Provider” in “WebAccess” in the GroupWise 8 Administration 
Guide. 


A copy of the commgr . cfg file is automatically maintained in the WebAccess Agent queue directory 
(domain\wpgate\webac8 0a). 
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logs directory 


The logs subdirectory holds WebAccess Application log files. For more information, see 
“Controlling WebAccess Application Logging” in “WebAccess” in the GroupWise 8 Administration 


Guide. 


9.2 OES 11 Apache/Tomcat Installation Directories 


In addition to the files installed into the Apache and Tomcat installation directories, GroupWise Web 
application files are also installed into the GroupWise Web Application Working Directory. 


/etc/opt/novell/httpd 
gonia 
gw.conf 
gwcal.conf 


gwmon.conf 


/var/opt/novell/tomcat6 


Novell Apache installation directory 
Apache application configuration directory 
WebAccess Application configuration file 
Calendar Publishing Host Application configuration file 
Monitor Application configuration file 


Novell Tomcat installation directory 


webapps Web applications directory 
gw WebAccess document root directory 
index.html WebAccess Login page 
webaccess 
yyyymmddhhmm 
help Directory for WebAccess and Web console help files 
gwcal Calendar Publishing Host document root directory 
index.html Calendar Publishing Host Web page 
gwmon GroupWise Monitor document root directory 
index.html GroupWise Monitor Web console page 
com/novell 
gwmonitor 
help Directory for Monitor Web console help files 
gw.war Web application archive file for WebAccess 


gweal.war Web application archive file for the Calendar Publishing Host 


gwmon. war Web application archive file for Monitor 


/usr/sbin Standard directory for application scripts 


rcapache2 Script to start and stop the Apache Web server 


rcnovell-tomcat6 Script to start and stop the Novell version of Tomcat 


9.2.1  letcloptinovell/httpd directory 


The /etc/opt/novell/httpd directory is the standard Apache Web server installation directory on 
OES 11. 
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conf.d directory 


The conf .d directory holds configuration information for each Web application that has been 
installed for use with Apache. 


gw.conf file 


The gw. conf file includes the information that enables Apache to access the WebAccess Application 
files that have been installed into Tomcat. This file is a link to /etc/opt /novell/groupwise/ 
webaccess/gw.conf. 


gwcal.conf file 


The gwcal . conf file includes the information that enables Apache to access the Calendar Publishing 
Host Application files that have been installed into Tomcat. This file is a link to /etc/opt/novel1/ 
groupwise/calhost/gwcal.conf. 


gwmon.conf file 


The gwmon. conf file includes the information that enables Apache to access the Monitor Application 
files that have been installed into Tomcat. This file is a link to /etc/opt /novell/groupwise/ 
monitor/gwmon.conf. 


9.2.2  Ivarloptinovellltomcat6 directory 


The /var/opt/novell/tomcaté directory is the standard Tomcat installation directory on OES 11. 


webapps directory 


The webapps directory holds a subdirectory for each GroupWise Web application that is installed on 
the server. 


gw directory 


The gw directory holds all WebAccess Application files that are installed into Tomcat. 


index.html file 


The index.html file in the gw directory is the WebAccess Login page. Itis displayed when you go to 
the following URL: 


http://web_server_address/gw 


gwcal directory 


The gweal directory holds all Calendar Publishing Host Application files that are installed into 
Tomcat. 


index.html file 


The index.html file in the gwcal directory is the default HTML page for the GroupWise Calendar 
Publishing Host. Itis displayed when you go to the following URL: 


http://web_server_address/gwcal 
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9.2.3 


9.3 


For more information, see “Calendar Publishing Host” in the GroupWise 8 Administration Guide. 


gwmon directory 


The gwmon directory holds all Monitor Application files that are installed into Tomcat. 


gwmonlindex.html file 


The index.html file in the gwmon directory is the default HTML page for the GroupWise Monitor 
Web console. It is displayed when you go to the following URL: 


http://web_server_address/gwmon 


For more information, see “Monitor Web Console” in “Monitor” in the GroupWise 8 Administration 
Guide. 


* war files 


The *.war files are Web application archive files, compressed files from which the Web application 
files are extracted during installation to create the corresponding application subdirectory. 


lusr/sbin directory 


The /usr/sbin directory is the standard location for application scripts that can be run from any 
directory on the Linux server. The /usr/sbin directory is always on included in the PATH 
environment variable. Files in this directory are links to the corresponding script files in /etc/ 
init.d. 


OES 2 Linux Apache/Tomcat Installation Directories 


In addition to the files installed into the Apache and Tomcat installation directories, GroupWise Web 
application files are also installed into the GroupWise Web Application Working Directory. 


/etc/opt/novell/httpd 
conta 
gw.conf 
gwcal.conf 


gwmon.conf 


/var/opt/novell/tomcat5 


Novell Apache installation directory 

Apache application configuration directory 
WebAccess Application configuration file 

Calendar Publishing Host Application configuration file 
Monitor Application configuration file 


Novell Tomcat installation directory 


webapps Web applications directory 

gw WebAccess document root directory 

index.html WebAccess Login page 

webaccess 

yyyymmddhhmm 
help Directory for WebAccess and Web console help files 

gweal Calendar Publishing Host document root directory 

index.html Calendar Publishing Host Web page 
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gwmon GroupWise Monitor document root directory 


index.html GroupWise Monitor Web console page 
com/novell 
gwmonitor 
help Directory for Monitor Web console help files 
gw.war Web application archive file for WebAccess 
gwcal.war Web application archive file for the Calendar Publishing Host 
gwmon . war Web application archive file for Monitor 
/usr/sbin Standard directory for application scripts 
rcapache2 Script to start and stop the Apache Web server 
rcnovell-tomcat5 Script to start and stop the Novell version of Tomcat 


9.3.1  letcloptinovell/httpd directory 


The /etc/opt/novell/httpd directory is the Apache Web server installation directory on OES 2 
Linux. 


conf.d directory 


The conf .d directory holds configuration information for each Web application that has been 
installed for use with Apache. 


gw.conf file 
The gw. conf file includes the information that enables Apache to access the WebAccess Application 


files that have been installed into Tomcat. This file is a link to /etc/opt /novell/groupwise/ 
webaccess/gw.conf. 


gwcal.conf file 
The gwcal . conf file includes the information that enables Apache to access the Calendar Publishing 


Host Application files that have been installed into Tomcat. This file is a link to /etc/opt/novel1/ 
groupwise/calhost/gwcal.conf. 


gwmon.conf file 


The gwmon. conf file includes the information that enables Apache to access the Monitor Application 
files that have been installed into Tomcat. This file is a link to /etc/opt /novell/groupwise/ 
monitor/gwmon.conf. 


9.3.2  Ivarloptinovellltomcat5 directory 


The /var/opt/novel1/tomcat5 directory is the standard Tomcat installation directory on OES 2 
Linux. 
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9.3.3 


webapps directory 


The webapps directory holds a subdirectory for each GroupWise Web application that is installed on 
the server. 


gw directory 
The gw directory holds all WebAccess Application files that are installed into Tomcat. 


index.html file 


The index.html file in the gw directory is the WebAccess Login page. It is displayed when you go to 
the following URL: 


http://web_server_address/gw 


gwcal directory 


The gwcal directory holds all Calendar Publishing Host Application files that are installed into 
Tomcat. 


index.html file 


The index.html file in the gwcal directory is the default Web page for the GroupWise Calendar 
Publishing Host. It is displayed when you go to the following URL: 


http://web_server_address/gwcal 


gwmon directory 


The gwmon directory holds all Monitor Application files that are installed into Tomcat. 


gwmonlindex.html file 


The index.html file in the gwmon directory is the default Web page for the GroupWise Monitor Web 
console. It is displayed when you go to the following URL: 


http://web_server_address/gwmon 


* war files 


The *.war files are Web application archive files, compressed files from which the Web application 
files are extracted during installation to create the corresponding application subdirectory. 


lusr/sbin directory 


The /usr/sbin directory is the standard location for application scripts that can be run from any 
directory on the Linux server. The /usr/sbin directory is always on included in the PATH 
environment variable. Files in this directory are links to the corresponding script files in /etc/ 
init.d. 


Web Application Installation Directories on Your Web Server 143 


9.4 SLES 11 Apache/Tomcat Installation Directories 


In addition to the files installed into the Apache and Tomcat installation directories, GroupWise Web 
application files are also installed into the GroupWise Web Application Working Directory. 


/etc/apache2 
Attpd conf 
conf .d 

gw.conf 
gwcal.conf 
gwmon.conf 


/usr/share/tomcat6 


webapps 


gw 
index.html 
webaccess 
yyyymmddhhmm 
help 


gwcal 
index.html 


gwmon 
index.html 
com/novell 
gwmonitor 
help 


gw.war 
gwcal.war 


gwmon. war 


/usr/sbin 
rcapache2 
rctomcat6 


9.4.1  Jetclapache2 directory 


Apache installation directory 

Main Apache Web server configuration file 

Apache application configuration directory 
WebAccess Application configuration file 

Calendar Publishing Host Application configuration file 
Monitor Application configuration file 


Tomcat installation directory 
Web applications directory 


WebAccess document root directory 
WebAccess Login page 


Directory for WebAccess and Web console help files 


Calendar Publishing Host document root directory 
Calendar Publishing Host page 


GroupWise Monitor document root directory 
GroupWise Monitor Web console page 


Directory for Monitor Web console help files 


Web application archive file for WebAccess 
Web application archive file for the Calendar Publishing Host 
Web application archive file for Monitor 


Standard directory for application scripts 
Script to start and stop the Apache Web server 
Script to start and stop Tomcat 


The /etc/apache2 directory is the standard Apache Web server installation directory on SLES 11. 


httpd.conf file 


The httpd.conf file is the main Apache configuration file. 
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9.4.2 


conf.d directory 


The conf .d directory holds configuration information for each Web application that has been 
installed for use with Apache. 


gw.conf file 


The gw. conf file provides the information that enables Apache to access the WebAccess Application 
files that have been installed into Tomcat. This file is a link to /etc/opt /novell/groupwise/ 
webaccess/gw.conf. 


gwcal.conf file 


The gwcal .conf file provides the information that enables Apache to access the GroupWise Calendar 
Publishing Host Application files that have been installed into Tomcat. This file is a link to /etc/opt/ 
novell/groupwise/calhost/gwcal.conf. 


gwmon.conf file 


The gwmon. conf file provides the information that enables Apache to access the Monitor Application 
files that have been installed into Tomcat. This file is a link to /etc/opt /novell/groupwise/ 
monitor/gwmon.conf. 


lusrIshareltomcat6 directory 


The /usr/share/tomcat6 directory is the standard Tomcat installation directory on SLES 11. 


webapps directory 


The webapps directory holds a subdirectory for each GroupWise Web application that is installed on 
the server. 


gw directory 
The gw directory holds all WebAccess Application files that are installed into Tomcat. 


index.html file 


The index.html file in the gw directory is the WebAccess Login page. Itis displayed when you go to 
the following URL: 


http://web_server_address/gw 


gwcal directory 


The gweal directory holds all Calendar Publishing Host Application files that are installed into 
Tomcat. 


index.html file 


The index.html file in the gwcal directory is the default page for the GroupWise Calendar 
Publishing Host. Itis displayed when you go to the following URL: 


http://web_server_address/gwcal 
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gwmon directory 


The gwmon directory holds all Monitor Application files that are installed into Tomcat. 


index.html file 


The index.html file in the gwmon directory is the default page for the GroupWise Monitor Web 
console. Itis displayed when you go to the following URL: 


http: //web_server_address/gwmon 


* war files 


The *.war files are Web application archive files, compressed files from which the Web application 
files are extracted during installation to create the corresponding application subdirectory. 


9.4.3  lusrisbin 


The /usr/sbin directory is the standard location for application scripts that can be run from any 
directory on the Linux server. The /usr/sbin directory is always included in the PATH environment 
variable. Files in this directory are links to the corresponding script files in /etc/init.c. 


9.5 SLES 10 Apache/Tomcat Installation Directories 


In addition to the files installed into the Apache and Tomcat installation directories, GroupWise Web 
application files are also installed into the GroupWise Web Application Working Directory. 


/etc/apache2 
httpd cont 
gonia 

gw.conf 
gwcal.conf 


gwmon.conf 


/srv/www/tomcat5/base 
webapps 


gw 
index.html 
webaccess 
yyyymmddhhmm 
help 


gwcal 
index.html 


Apache installation directory 

Main Apache Web server configuration file 

Apache application configuration directory 
WebAccess Application configuration file 

Calendar Publishing Host Application configuration file 
Monitor Application configuration file 


Tomcat installation directory 
Web applications directory 


WebAccess document root directory 
WebAccess Login page 


Directory for WebAccess and Web console help files 


Calendar Publishing Host document root directory 
Calendar Publishing Host page 
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gwmon GroupWise Monitor document root directory 


index.html GroupWise Monitor Web console page 
com/novell 
gwmonitor 
help Directory for Monitor Web console help files 
gw.war Web application archive file for WebAccess 
gwcal.war Web application archive file for the Calendar Publishing Host 
gwmon. war Web application archive file for Monitor 
/usr/sbin Standard directory for application scripts 
rcapache2 Script to start and stop the Apache Web server 
rctomcat5 Script to start and stop Tomcat 


9.5.1  letclapache2 directory 


The /etc/apache2 directory is the standard Apache Web server installation directory on SLES 11. 


httpd.conf file 


The httpd.conf file is the main Apache configuration file. 


conf.d directory 


The conf .d directory holds configuration information for each Web application that has been 
installed for use with Apache. 


gw.conf file 


The gw. conf file provides the information that enables Apache to access the WebAccess Application 
files that have been installed into Tomcat. This file is a link to /etc/opt /novell/groupwise/ 
webaccess/gw.conf. 


gwcal.conf file 


The gwcal . conf file provides the information that enables Apache to access the GroupWise Calendar 
Publishing Host Application files that have been installed into Tomcat. This file is a link to /etc/opt/ 
novell/groupwise/calhost/gwcal.conf. 


gwmon.conf file 


The gwmon. conf file provides the information that enables Apache to access the Monitor Application 
files that have been installed into Tomcat. This file is a link to /etc/opt /novell/groupwise/ 
monitor/gwmon.conf. 


9.5.2 /srviwwwitomcat5/base directory 


The /srv/www/tomcat5/base directory is the standard Tomcat installation directory on SLES 10. 
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webapps directory 


The webapps directory holds a subdirectory for each GroupWise Web application that is installed on 
the server. 


gw directory 
The gw directory holds all WebAccess Application files that are installed into Tomcat. 


index.html file 


The index.html file in the gw directory is the WebAccess Login page. Itis displayed when you go to 
the following URL: 


http://web_server_address/gw 


gwcal directory 


The gwcal directory holds all Calendar Publishing Host Application files that are installed into 
Tomcat. 


index.html file 


The index.html file in the gwcal directory is the default page for the GroupWise Calendar 
Publishing Host. Itis displayed when you go to the following URL: 


http://web_server_address/gwcal 


gwmon directory 
The gwmon directory holds all Monitor Application files that are installed into Tomcat. 


index.html file 


The index.html file in the gwmon directory is the default page for the GroupWise Monitor Web 
console. It is displayed when you go to the following URL: 


http://web_server_address/gwmon 


* war files 


The *.war files are Web application archive files, compressed files from which the Web application 
files are extracted during installation to create the corresponding application subdirectory. 


9.5.3  lusrisbin 


The /usr/sbin directory is the standard location for application scripts that can be run from any 
directory on the Linux server. The /usr/sbin directory is always included in the PATH environment 
variable. Files in this directory are links to the corresponding script files in /etc/init.c. 
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9.6 Windows IIS/Tomcat Installation Directories 


Mc: /Inetpub/wwwroot 


HA] c: /Novell/GroupWise/Tomcat5.5 


El webapps / gw 
_] index.html 


EA] com/novell/webaccess 
a com/novell/webpublisher 


Ëa webaccess 
E webpublisher 


| WEB-INF 
Jj web.xml 


YH] classes/com/novell 


EU] webaccess 


am. 


ES] providers 


E] webpublisher 
E providers 


E classes/templates 


E webapps/gwcal 
Jj index.html 


ZE] WEB- INF 
Jj web.xml 


Es] webapps /gwmon 
Jj index.html 


| WEB- INF 
LJ web.xml 


HA] classes/templates 


HA] c: /Novell/Groupwise 


a calhost 
_] calhost.cfg 
E logs 

E] gwmonitor 


_] gwmonitor.cfg 
a logs 
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IIS directory for publishing content to the Web 


Tomcat installation directory 


GroupWise-specific Web applications directory 
GroupWise-specific Web services page 


Directory for WebAccess help files 
Directory for WebPUblisher help files 


Directory for GroupWise WebAccess Application files 
Directory for GroupWise WebPublisher Application files 


GroupWise Web service information directory 
GroupWise Web service configuration file 


Directory for Novell product files 


Directory for GroupWise WebAccess files 
Subdirectory for service provider files 


Directory for GroupWise WebPublisher files 
Subdirectory for service provider files 


GroupWise Web service template files 


Calendar Publishing Host document root directory 
Calendar Publishing Host Web services page 


Calendar Publishing Host Web service information directory 
Calendar Publishing Host Web service configuration file 


GroupWise Monitor document root directory 
GroupWise Monitor Web services page 


GroupWise Monitor Web service information directory 
GroupWise Monitor Web service configuration file 


GroupWise Monitor Web service template files 


Directory for GroupWise Web services files 


Subdirectory for the Calendar Publishing Host 
Calendar Publishing Host configuration file 
Directory for Calendar Publishing Host log files 


Subdirectory for GroupWise Monitor 
Monitor Application configuration file 
Directory for Monitor Application log files 
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E webaccess Subdirectory for WebAccess 


_] webacc.cfg WebAccess Application configuration file 
_] commgr.cfg Communications Manager configuration file 
L] ldap.cfg LDAP service provider configuration file 
el logs Directory for WebAccess Application log files 
E users Directory for WebAccess users' session files 
E] webpublisher Subdirectory for WebAccess Application files 
_] webpub.cfg WebPublisher Application configuration file 
_] commgr.cfg Communications Manager configuration file 
S| logs Subdirectory for WebPublisher Application log files 


9.6.1  c:linetpublwwwroot directory 


The /inetpub/wwwroot directory is the standard Internet Information Services directory for 
publishing content to the Web. 


9.6.2 _c:/Novell/GroupWise/Tomcat5.5iwebapps directory 


The /Novell/GroupWise/Tomcat5 .5/webapps directory is where applications are installed into the 
Web server. 


gwiindex.html file 


The index.html file in the gw directory is the default HTML file for the GroupWise client Web 
services (WebAccess and WebPublisher) and displays when you go to the following URL: 


http://web_server_address/gw 


From this default page, WebAccess and WebPublisher URLs can be easily accessed: 


http://web_server_address/gw/webacc 
http://web_server_address/gw/webpub 


gw/WEB-INF/web.xml file 


The web. xml file tells the Web server where the various GroupWise service providers and their 
configuration files are located. By default, they are located in subdirectories under 
sys: \Novell\GroupWise. 


gw/WEB-INFiclasses/com/novelliwebaccess/providers directory 
The providers directory holds the Java class and properties files for the WebAccess providers. For 


more information, see “Adding or Removing Service Providers” in “WebAccess” in the GroupWise 8 
Administration Guide. 


gw/WEB-INFiclasses/com/novelliwebpublisher/providers directory 
The providers directory holds the Java class and properties files for the WebPublisher providers. For 


more information, see “Adding or Removing Service Providers” in “WebAccess” in the GroupWise 8 
Administration Guide. 
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9.6.3 


9.6.4 


gw/WEB-INFiclasses/templates directory 
The templates directory holds subdirectories for the various file formats used in various browser 


environments. For more information, see “Modifying WebAccess Application Template Settings” in 
“WebAccess” in the GroupWise 8 Administration Guide. 


gwcal/index.html file 


The index.html file in the gwcal directory is the default HTML file for the GroupWise Calendar 
Publishing Host Web service and displays when you go to the following URL: 


http://web_server_address/gwcal 


gwcal/WEB-INF/web.xml file 


The web.xml file tells the Web server where the Calendar Publishing Host service provider and its 
configuration file are located. 


gwmon/index.html file 


The index.html file in the gwmon directory is the default HTML file for the GroupWise Monitor Web 
service and displays when you go to the following URL: 


http://web_server_address/gwmon 


gwmon/WEB-INF/web.xml file 


The web.xml file tells the Web server where the GroupWise Monitor service provider and its 
configuration file are located. 


gwmon/WEB-INFiclasses/templates directory 


The templates directory holds subdirectories for the various file formats used in various browser 
environments. For more information, see “Modifying Monitor Application Template Settings” in 
“Monitor” in the GroupWise 8 Administration Guide. 


c:/Novell/GroupWise directory 


The /Novell/GroupWise directory holds subdirectories for each GroupWise application. 


calhost directory 


The calhost directory is created when you install the Calendar Publishing Host. 


calhost.cfg file 
The calhost.cfg file holds Calendar Publishing Host configuration information. For more information, 


see “Configuring the Calendar Publishing Host” in “Calendar Publishing Host” in the GroupWise 8 
Administration Guide. 
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9.6.5 


9.6.6 


logs directory 
The logs subdirectory holds Calendar Publishing Host Application log files. For more information, 


see “Using Calendar Publishing Host Log Files” in “Calendar Publishing Host” in the GroupWise 8 
Administration Guide. 


gwmonitor directory 


The gwmonitor directory is created when you install GroupWise Monitor. 


gwmonitor.cfg file 


The gwmonitor.cfg file holds the same configuration information that is stored on the Monitor 
Application object (named GroupWiseMonitor) in eDirectory. For more information, see 
“Configuring the Monitor Application” in “Monitor” in the GroupWise 8 Administration Guide. 


logs directory 


The logs subdirectory holds Monitor Application log files. For more information, see “Modifying 
Monitor Application Log Settings” in “Monitor” in the GroupWise 8 Administration Guide. 


webaccess directory 


The webaccess directory holds files used by the WebAccess Application. 


webacc.cfg file 


The webacc . cfg file holds the same configuration information that is stored on the WebAccess 
Application object (named GroupWiseWebAccess) in eDirectory. For more information, see 
“Configuring the WebAccess Application” in “WebAccess” in the GroupWise 8 Administration Guide. 


commgor.cfg file 


The commgr .cfg file holds the same configuration information that is stored on the GroupWise 
Provider object (named GroupWiseProvider) in eDirectory, including the IP address, port number, 
number of threads, and encryption key for the WebAccess Agent. This information enables the 
WebAccess Application to communicate with the WebAccess Agent. For more information, see 
“Configuring the GroupWise Service Provider” in “WebAccess” in the GroupWise 8 Administration 
Guide. 


A copy of the commgr . cfg file is automatically maintained in the WebAccess Agent queue directory 
(domain\wpgate\webac80a). 
Idap.cfg file 


The ldap.cfg file holds the same configuration information that is stored on the LDAP Provider 
object (named LDAPProvider) in eDirectory. For more information, see “Configuring the LDAP 
Service Provider” in “WebAccess” in the GroupWise 8 Administration Guide. 
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9.6.7 


9.7 


logs directory 


The logs subdirectory holds WebAccess Application log files. For more information, see 
“Controlling WebAccess Application Logging” in “WebAccess” in the GroupWise 8 Administration 
Guide. 


users directory 


The users subdirectory holds session files for WebAccess users. If WebAccess times out after a 
period of user inactivity, the user’s session information is saved. When the user logs back in, the 
session information is retrieved so that the user can continue working without loss of data. Also, 
users’ message text is saved during each session, so that if the WebAccess Application is restarted or 
goes down, users do not lose the message text they were composing at the time. 


webpublisher directory 


The webpublisher directory holds files used by the WebPublisher Application. 


webpub.cfg file 


The webpub . cfg file holds the same configuration information that is stored on the WebPublisher 
Application object (named GroupWiseWebPublisher) in eDirectory. For more information, see 
“Configuring the WebPublisher Application” in “WebAccess” in the GroupWise 8 Administration 
Guide. 


commgr.cfg file 


The commgr . cfg file holds the same configuration information that is stored on the GroupWise 
Provider object (named GroupWiseProvider) in eDirectory, including the IP address, port number, 
number of threads, and encryption key for the WebAccess Agent. This information enables the 
WebAccess Application to communicate with the WebAccess Agent. For more information, see 
“Configuring the GroupWise Service Provider” in “WebAccess” in the GroupWise 8 Administration 
Guide. 


A copy of the commgr . cfg file is automatically maintained in the WebAccess Agent queue directory 
(domain\wpgate\webac80a). 


logs directory 
The logs subdirectory holds WebAccess Application log files. For more information, see 


“Controlling WebAccess Application Logging” in “WebAccess” in the GroupWise 8 Administration 
Guide. 


GroupWise Web Application Working Directory 


/var/opt/novell/groupwise Directory for GroupWise Web application files on Linux 
c:\novell\groupwise Directory for GroupWise Web application files on Windows 
sys: \novell\groupwise Directory for GroupWise Web application files on NetWare 
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webaccess Subdirectory for WebAccess 


webacc.cfg WebAccess Application configuration file 
ldap.cfg LDAP service provider configuration file 
gwac.xml Access control configuration file 
logs Directory for WebAccess Application log files 
users Directory for WebAccess users’ session files 
calhost Subdirectory for the Calendar Publishing Host 
calhost.cfg Calendar Publishing Host configuration file 
logs Directory for Calendar Publishing Host log files 
monitor Subdirectory for GroupWise Monitor 
gwmonitor.cfg Monitor Application configuration file 
logs Directory for Monitor Application log files 


9.7.1 /varloptinovell/groupwise directory 


The /var/opt/novell/groupwise directory holds a subdirectory for each GroupWise Web 
application that is installed on the Linux server. 


The c:\Novel1\GroupWise directory holds a subdirectory for each GroupWise Web application that 
is installed on the Windows server. 


The sys: \Novell\GroupWise directory holds a subdirectory for each GroupWise Web application 
that is installed on the NetWare server. 


webaccess directory 


The webaccess directory is created when you install WebAccess. It holds files used by the WebAccess 
Application. 


webacc.cfg file 


The webacc . cfg file holds WebAccess configuration information. 


Idap.cfg file 


The ldap.cfg file holds LDAP configuration information. 


gwac.xml file 


The gwac.xml file holds WebAccess access control configuration information. 


logs directory 


The logs subdirectory holds WebAccess Application log files. 
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users directory 
The users subdirectory holds session files for WebAccess users. 


If WebAccess times out after a period of user inactivity, the user's session information is saved. When 
the user logs back in, the session information is retrieved so that the user can continue working 
without loss of data. Also, users’ message text is saved during each session, so that if the WebAccess 
Application is restarted or goes down, users do not lose the message text they were composing at the 
time. 


calhost directory 


The calhost directory is created when you install the Calendar Publishing Host. It holds files that 
are used by the Calendar Publishing Host Application. 


calhost.cfg file 


The calhost.cfg file holds Calendar Publishing Host configuration information. 


logs directory 


The logs subdirectory holds Calendar Publishing Host Application log files. 


monitor directory 


The monitor directory is created when you install Monitor. It holds files that are used by the Monitor 
Application. 


gwmonitor.cfg file 


The gwmonitor.cfg file holds Monitor Application configuration information. 


logs directory 


The logs subdirectory holds Monitor Application log files. 
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0 Software Distribution Directory 


+ Section 10.1, “NetWare/Windows Software Distribution Directory,” on page 157 


+ Section 10.2, “Linux Software Distribution Directory,” on page 163 


10.1 NetWare/Windows Software Distribution Directory 


EN] software distribution Master copy of GroupWise software 


directory 
LJ setup.exe 


el agents 
_] install.exe 
E nlm 
eS nt 
al startups 
el snmp 
w help 


E domain 
_] wpdomain. dc 
_] gwdom.dc 
_] wphost .de 
_] gwpo.dc 

È po 
O ngwguard.dc 
_] wphost .de 
LJ gwpo.dc 


@ client 

E win32 
_] setup.exe 
_] setup.cfg 
al gwcheck 
E ofviews 
E] ppforms 
E uwl 


HA] admin 
HN] cladmin 
ZN] monitor 


GroupWise Installation program 


GroupWise agent software 
GroupWise Agent Installation program 
NetWare agent software 

Windows agent software 

Agent startup files 

GroupWise MIB files 

Agent Web console help files 


Domain data dictionary files 

Data dictionary for GroupWise 4.x domain databases 

Data dictionary for GroupWise 8, 7, 6.x, and 5.x domain databases 
Data dictionary for GroupWise 4.x post office databases 

Data dictionary for GroupWise 8, 7, 6.x, and 5.x post office databases 


Post office data dictionary files 

Data dictionary for message store databases 

Data dictionary for GroupWise 4.x post office databases 

Data dictionary for GroupWise 8, 7, 6.x, and 5.x post office databases 


GroupWise client software 

GroupWise client for Windows 

GroupWise client installation program 
Configuration file for the AutoUpdate feature 
GroupWise Check utility 

GroupWise client view files 

GroupWise client day planner forms 
GroupWise client user word lists 


GroupWise administrator software 
GroupWise snap-ins to ConsoleOne 
GroupWise Monitor software 
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E Utility GroupWise administrative utilities 


E gwcheck GroupWise Check utility 
E gwesrgen GroupWise Generate CSR utility 
E setupip GroupWise TCP/IP Setup utility 
HH] internet Internet connectivity software 
E] gwia GroupWise Internet Agent software 
B webaccess GroupWise WebAccess software 
HA] license GroupWise Software License Agreement in multiple languages 
E common Java files used by GroupWise programs 
8] docs GroupWise Installation Guide 


10.1.1 \grpwiselsoftware directory 


The GroupWise software distribution directory resides initially on the GroupWise 8 DVD or 
GroupWise 8 downloaded software image. GroupWise Administration is installed directly from the 
original media. In addition, during installation, you create a software distribution directory on your 
network from which you subsequently install the GroupWise agents and GroupWise client software. 


The default software distribution directory is \grpwise\software. 


10.1.2 setup.exe file 


The setup.exe file is the GroupWise Installation program. You can run it in a software distribution 
directory to install software from that location. 


10.1.3 agents directory 


The agents subdirectory contains all files associated with GroupWise agents: 
+ Post Office Agent (POA) 
+ Message Transfer Agent (MTA) 
install.exe file 
The install.exe file in the agent subdirectory is the installation program you run to install the 


GroupWise agents on the servers where you will run the POA and/or MTA. For instructions, see 
“Installing GroupWise Agents” in the GroupWise 8 Installation Guide. 


nim directory 


The nlm subdirectory in the agent subdirectory contains the GroupWise agent NLM files installed on 
NetWare servers. See “NetWare Installation Directory” on page 99. 


nt directory 


The nt subdirectory contains the GroupWise agent files installed on Windows servers. See 
“Windows Installation Directory” on page 108. 
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10.1.4 


startups directory 


The startups subdirectory contains the default startup files for the GroupWise agents. During 
installation, a customized startup file is created for each agent that includes the location of the 
domain or post office serviced by that agent. The customized startup files are named after the 
domain or post office for which they are created. See “NetWare Installation Directory” on page 99 or 
“Windows Installation Directory” on page 108. 


snmp directory 


The snmp subdirectory contains GroupWise MIB files. For more information, see “Using an SNMP 
Management Console” in “Post Office Agent” and “Message Transfer Agent” in the GroupWise 8 
Administration Guide. 


help directory 


The help directory holds the help files that you can view from the agent Web consoles. See “Using 
the POA Web Console” in “Post Office Agent” and “Using the MTA Web Console” in “Message 
Transfer Agent” in the GroupWise 8 Administration Guide. 


domain directory 


The domain subdirectory contains the files from which domains are created. 


wpdomain.dc file 


The wpdomain. dc file is the distribution copy of the data dictionary for rebuilding GroupWise 4.x 
domain databases (wpdomain. db files) in secondary domains. 


If the wpdomain.dc file is missing from the primary domain, you cannot rebuild GroupWise 4.x 
secondary domains. The original wpdomain. dc file is located in the domain directory of the 
GroupWise distribution media. 


Historical Note: WordPerfect Office (WP Office), the predecessor of GroupWise, was originally 
designed by WordPerfect Corporation (WPCorp). Hence, the wp in wedomain.dc. Some naming 
conventions were originally preserved for backward compatibility. 


gwdom.dc file 


The gwdom. dc file is the distribution copy of the data dictionary for creating and rebuilding 
GroupWise 8, 7, 6.x, and GroupWise 5.x domain databases (wpdomain. db files) in secondary 
domains. 


If the gwdom. dc file is missing from the primary domain, you cannot create or rebuild GroupWise 8/ 
7/6.x/5.x secondary domains. The original gwdom. dc file is located in the domain subdirectory of the 
GroupWise distribution media. 


Historical Note: WP Office, the predecessor of GroupWise, was originally designed by WordPerfect 
Corporation (WPCorp). Hence, the wp in wodomain.db. Some naming conventions were originally 
preserved for backward compatibility. 
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wphost.dc file 


The wphost . de file is the distribution copy of the data dictionary for rebuilding GroupWise 4.x post 
office databases (wphost . db files). 


If the wphost . de file is missing from a domain, you cannot rebuild GroupWise 4.x post offices in that 
domain. The original wphost . dc file is located in the domain subdirectory of the GroupWise 
distribution media. There is also a copy in the po subdirectory. 


Historical Note: WP Office, the predecessor of GroupWise, was originally designed by WordPerfect 
Corporation (WPCorp). Post offices were originally called hosts. Hence, the name wphost .dc. Some 
naming conventions were originally preserved for backward compatibility. 


gwpo.dc file 


The gwpo. de file is the distribution copy of the data dictionary for creating and rebuilding 
GroupWise 8, 7, 6.x, and GroupWise 5.x post office databases (wphost.db files). 


If the gwpo. de file is missing from a domain, you cannot create or rebuild GroupWise 8/7/6.x/5.x post 
offices in that domain. The original gwpo. dc file is located in the domain directory of the GroupWise 8 
DVD or GroupWise 8 downloaded software image. There is also a copy in the po directory. 


Historical Note: WP Office, the predecessor of GroupWise, was originally designed by WordPerfect 
Corporation (WPCorp). Post offices were originally called hosts. Hence, the name wphost . db. Some 
naming conventions were originally preserved for backward compatibility. 


10.1.5 po directory 


The po subdirectory contains the files from which post offices are created. 


ngwguard.dc file 


The ngwguard. dc file is the distribution copy of the data dictionary for building the following 
databases in the post office: 


+ ngwguard.db (guardian database) 
dmxxnn01 -FF (document management databases) 
msgnnn. db (message databases) 
userxxx.db (user databases) 
puxxxxx.db (databases for replicated items like shared folders) 


If the ngwguard. de file is missing from a post office, new databases cannot be created in the post 
office, so the post office cannot grow. The original ngwguard.dc file is located in the po directory of 
the GroupWise 8 DVD or GroupWise 8 downloaded software image. 


In Remote mode, the GroupWise client also uses the ngwguard. dc file as the data dictionary for its 
local databases. 


10.1.6 client directory 


The client subdirectory contains all files associated with GroupWise Windows client. See “Client” 
in the GroupWise 8 Administration Guide. 
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10.1.7 


10.1.8 


10.1.9 


10.1.10 


10.1.11 


win32 directory 


The win32 subdirectory contains all GroupWise client files installed for use with Windows. See 
Section 11.1, “Windows Client,” on page 173. 


setup.exe file 


The setup.exe file is the program GroupWise client users run to install and set up the GroupWise 
client on their Windows workstations. See “Client” in the GroupWise 8 Administration Guide. 


setup.cfg file 
The setup. cfg file enables you to automate installation of the GroupWise Windows client so that 


your users do not need to respond to the Setup program’s prompts. For more information, see 
“Understanding the Setup Configuration File” in “Client” in the GroupWise 8 Administration Guide. 


gwcheck directory 
The gwcheck subdirectory contains the GroupWise Check utility that can be made available in the 


GroupWise client by clicking Tools > Repair Mailbox. For more information, see “Repairing Your 
Mailbox” in “Maintaining GroupWise” in the GroupWise 8 Windows Client User Guide. 


ofviews directory 


The ofviews subdirectory contains platform-specific subdirectories of view files for use by the 
GroupWise client. In addition, the gwviewxx. ini and ofviewxx. ini files configure custom views on 
the menus where users select views. The gwviewxx. ini file configures GroupWise 8, 7, 6.x, and 
GroupWise 5.5 views. The ofviewxx.ini file configures views from earlier versions of GroupWise. 


ppforms directory 


The ppforms subdirectory contains day planner forms for printing GroupWise calendars and tasks. 


uwl directory 


The uwl directory stores the wt61xx.uwl files that are used when users add words to the word list 
during spell checking. 


admin directory 


The admin subdirectory contains subdirectories for administrative tools that can be used with 
GroupWise. 


cladmin directory 


The admin\cladmin subdirectory contains the GroupWise snap-ins to ConsoleOne. 


Software Distribution Directory 161 


10.1.12 


monitor directory 


The admin\monitor subdirectory contains the GroupWise 8/7/6.x Monitor program, an SNMP 
monitoring program for use with the GroupWise agents. See “Monitor” in the GroupWise 8 
Administration Guide. 


utility directory 


The admin\utility subdirectory contains helpful GroupWise utilities. 


gwcheck directory 


The admin\utility\gwcheck subdirectory contains the GroupWise Check utility. See “GroupWise 
Check” in “Standalone Database Maintenance Programs” in the GroupWise 8 Administration Guide. 


gwcsrgen directory 


The admin\utility\gwcsrgen subdirectory contains the GroupWise Generate CSR utility. See 
“Server Certificates and SSL Encryption” in “Security Administration” in the GroupWise 8 
Administration Guide. 


setupip directory 


The admin\utility\setupip subdirectory contains supporting programs for the client AutoUpdate 
feature. See “Customizing the Setup Configuration File” in “Client” in the GroupWise 8 Administration 
Guide. 


internet directory 


The internet subdirectory contains subdirectories for GroupWise components that provide Internet 
connectivity. 


gwia directory 


The internet\gwia subdirectory contains the GroupWise Internet Agent software, used to connect 
GroupWise systems across the Internet and to allow GroupWise users to exchange e-mail with users 
of various Internet e-mail programs. For information about Internet Agent files and directories, see 
Section 7.5, “Internet Agent Queue Directory,” on page 83 and Section 8.2, “Internet Agent 
Installation,” on page 110. 


For information about the Internet Agent, see “Internet Agent” in the GroupWise 8 Administration 
Guide. 


webaccess directory 


The internet\webaccess subdirectory contains the GroupWise WebAccess software, which allows 
users to access their GroupWise mailboxes from a Web browser. For information about WebAccess 
files and directories, see Section 7.4, “WebAccess Agent Queue Directory,” on page 81, Section 8.3, 
“WebAccess Agent Installation,” on page 117, and Section 9, “Web Application Installation 
Directories on Your Web Server,” on page 133 


For information about WebAccess, see “WebAccess” in the GroupWise 8 Administration Guide. 
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10.1.13 license directory 


The license subdirectory contains the GroupWise Software License Agreement in multiple 
languages. Run license. exe, then select a language. 


10.1.14 common directory 


The common subdirectory contains Java files used by various components of GroupWise. 


10.1.15 docs directory 


The docs subdirectory contains language-specific subdirectories for the Installation Guide in PDF 
format. You can find the most up-to-date version of the GroupWise 8 Installation Guide on the 
GroupWise 8 Documentation Web site (http://www.novell.com/documentation/gw8). 


10.2 


Ša /opt/novell/groupwise/software 
_] install 


Es] agents 
HA] linux 


_] novell-groupwise-agents- 
ver.date.i386.rpm 


O novell-groupwise-gwha- 
ver.date.i386.rpm 


_] novel1-sms- ver. 1586.rpm 


@ startups 
Es] language 
L] strtupxx.poa 
L] strtupxx.mta 
_] grpwise 
El domain 
O wpdomain.dc 
_] gwdom. dc 
_] wphost .de 
L gwpo.dc 
È po 
_] ngwguard. dc 
_] wphost .de 
J gwpo.dc 
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Master copy of GroupWise software 
GroupWise Installation script 


GroupWise agent software 
Subdirectory for Linux software 
GroupWise agent package 


GroupWise High Availability service package 


Novell Storage Management Services package 


Subdirectory for startup files 

Language-specific files 

POA startup file 

MTA startup file 

GroupWise agent startup script (POA and MTA) 


Domain data dictionary files 

Data dictionary for GW 4.x domain databases 

Data dictionary for GW 8, 7, 6.x, and 5.x domain databases 
Data dictionary for GW 4.x post office databases 

Data dictionary for GW 8, 7, 6.x, and 5.x post office databases 


Post office data dictionary files 

Data dictionary for message store databases 

Data dictionary for GW 4.x post office databases 

Data dictionary for GW 8, 7, 6.x, and 5.x post office databases 
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E client 
E linux 
_] install 


O novell-groupwise- 
gwclient-ver.date.i386.rpm 


_] novell -groupwise- 
gwcheck-ver.date.i386.rpm 


HN] ofviews 


E admin 


_] novell -groupwise-admin- 
ver.date.i386.rpm 


_] novell -groupwise-dbcopy- 
ver.date.i386.rpm 


_] novell -groupwise-gwcheck- 
ver.date.i386.rpm 


_] NoVLc1Linuxjre-ver.i386.rpm 


EN] monitor 
HA] linux 


_] novell-groupwise- 
gwmon-ver.date.i386.rpm 


_] novell-groupwise- 
monitor-ver.date.i386.rpm 


@ startup 
_] grpwise-ma 





_] Snngrpwise-ma 


EN] internet 


ES] gwia 
E linux 


_] novell-groupwise-gwia- 
ver.date.i386.rpm 


_] novell-groupwise-gwha- 
ver.date.i386.rpm 


eS root 
_] gwia.cfg 
_] gwauth.cfg 
_] mimetype.cfg 
Ll] gwac.de 
_] preamble.txt 
_] preamble.all 
_] statusxx.xml 
a startup 
_] grpwise 


GroupWise client software 
Subdirectory for Linux software 
Linux client installation script 
Linux client package 


GroupWise Check Utility package 


GroupWise client view files 


GroupWise administrator software 
GroupWise snap-ins to ConsoleOne package 


GroupWise Database Copy Utility package 
GroupWise Check Utility package 


ConsoleOne JRE update package 


GroupWise Monitor software 
Subdirectory for Linux software 
Monitor Agent package 


Monitor Application package 


Subdirectory for startup files 
Monitor startup script 
Monitor startup script for automatic start on reboot 


Internet connectivity software 


GroupWise Internet Agent software 
Subdirectory for Linux software 
GroupWise Internet Agent package 


GroupWise High Availability service package 


Subdirectory for boilerplate supporting files 

Internet Agent startup file 

Host authentication configuration file 

MIME encoding configuration file 

Database dictionary for the access control database 
Message for non-MIME recipients 

Preamble message in various languages 

File for customizing status messages 

Subdirectory for startup files 

Internet Agent startup script 
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E webacces 
Eul linux 


_] novell-groupwise- 
gwinter-ver.date.i386.rpm 


_] novell-groupwise- 
webaccess-ver.date.i386.rpm 


el root 
_] mimetype.cfg 
Ll] gwac.de 
_] gwgs.ini 
=| startup 
_] grpwise 
_] Snngrpwise 
MD) webserver 
$) linux 
_] *.rpm 


HN] license 


Es] docs 


HA] gwinst 
_] clusterimport .conf 


10.2.1 


GroupWise WebAccess software 
Subdirectory for Linux software 
GroupWise WebAccess Agent package 


GroupWise WebAccess Application package 


Subdirectory for boilerplate supporting files 

MIME encoding configuration file 

Database dictionary for the access control database 
Gateway identifier file 

Subdirectory for startup files 

WebAccess Agent startup script 

WebAccess Agent startup script for automatic start on reboot 


Web server to support WebAccess and Monitor 
Subdirectory for Linux software 
Apache, Tomcat, and related packages 


GroupWise Software License Agreement in multiple 
languages 


GroupWise Readme, Quick Start, and Installation Guide 


Directories and files used by the Installation program 
Cluster configuration file 


loptinovell/groupwise/software directory 


The GroupWise software distribution directory resides initially on the GroupWise 8 DVD or 
GroupWise 8 downloaded software image. GroupWise Administration is installed directly from the 
original media. In addition, during installation, you can create a software distribution directory on 
your network from which you subsequently install the GroupWise agents and GroupWise client 


software. 


The default software distribution directory is /opt /novell/groupwise/software. 


install file 


The install file is the script you use to install all components of GroupWise on Linux. See “Linux: 
Setting Up a Basic GroupWise System” in the GroupWise 8 Installation Guide. 


10.2.2 agents directory 


The agents subdirectory contains all files associated with GroupWise agents: 


+ Post Office Agent (POA) 


+ Message Transfer Agent (MTA) 
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novell-groupwise-agents.version.date.i386.rpm 


The novell-groupwise-agents.version.date.i386.rpm file is the GroupWise agent package that 
is installed by the Installation script. It installs the POA and the MTA. You can install the agent 
package manually if necessary. To see what files are installed by the package, see Section 8.1.2, “Linux 
Installation Directory,” on page 103. 


novell-groupwise-gwha.version.date.i386.rpm 


The novell-groupwise-gwha. version. date.i386.rpm file is the GroupWise High Availability 
service package that is installed by the Installation script. It is automatically installed along with the 
POA and the MTA. You can install the High Availability package manually if necessary. To see what 
files are installed by the package, see Section 8.1.2, “Linux Installation Directory,” on page 103. 


novell-sms-version.i586.rpm 


The novell-sms-version.i586.rpm file is the Novell Storage Management Services package that is 
used in conjunction with the Service Agent for File Systems (TSAFS) and TSAFS for GroupWise 
(TSAFSGW) for the purpose of backing up GroupWise databases in a live GroupWise system. It is 
not installed by the Installation script but must be installed manually, as described in “Linux: 
Running TSAFS and TSAFSGW” in “Databases” in the GroupWise 8 Administration Guide. 


startups directory 


The startups subdirectory contains the default startup files for the GroupWise agents. During 
installation, a customized startup file is created for each agent that includes the location of the 
domain or post office serviced by that agent. The customized startup files are named after the 
domain or post office for which they are created. See Section 8.1.2, “Linux Installation Directory,” on 
page 103. 


grpwise file 


The grpwise file is the GroupWise agent startup script. It is installed in /etc/init .d. If you choose 
to have the agents start automatically when the server reboots, the Installation script places symbolic 
links to it named Snngrpwise in the rc3.d and rc5.d subdirectories of /etc/init.d. For more 
information, see “Installing and Starting the Linux GroupWise Agents” in “Installing a Basic 
GroupWise System” in the GroupWise 8 Installation Guide. 


10.2.3 domain directory 


The domain subdirectory contains the files from which domains are created. 


wpdomain.dc file 


The wpdomain. dc file is the distribution copy of the data dictionary for rebuilding GroupWise 4.x 
domain databases (wpdomain. db files) in secondary domains. 


If the wedomain. de file is missing from the primary domain, you cannot rebuild GroupWise 4.x 
secondary domains. The original wpdomain. dc file is located in the domain directory of the 
GroupWise distribution media. 
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10.2.4 


Historical Note: WordPerfect Office (WP Office), the predecessor of GroupWise, was originally 
designed by WordPerfect Corporation (WPCorp). Hence, the wp in wpdomain. dc. Some naming 
conventions were originally preserved for backward compatibility. 


gwdom.dc file 


The gwdom. dc file is the distribution copy of the data dictionary for creating and rebuilding 
GroupWise 8, 7, 6.x, and 5.x domain databases (wpdomain. db files) in secondary domains. 


If the gwdom.dc file is missing from the primary domain, you cannot create or rebuild GroupWise 8/ 
7/6.x/5.x secondary domains. The original gwdom. de file is located in the domain subdirectory of the 
GroupWise distribution media. 


Historical Note: WP Office, the predecessor of GroupWise, was originally designed by WordPerfect 
Corporation (WPCorp). Hence, the wp in wodomain. db. Some naming conventions were originally 
preserved for backward compatibility. 


wphost.dc file 


The wphost .dc file is the distribution copy of the data dictionary for rebuilding GroupWise 4.x post 
office databases (wphost . db files). 


If the wphost . de file is missing from a domain, you cannot rebuild GroupWise 4.x post offices in that 
domain. The original wphost . dc file is located in the domain subdirectory of the GroupWise 
distribution media. There is also a copy in the po subdirectory. 


Historical Note: WP Office, the predecessor of GroupWise, was originally designed by WordPerfect 
Corporation (WPCorp). Post offices were originally called hosts. Hence, the name wphost .dc. Some 
naming conventions were originally preserved for backward compatibility. 


gwpo.dc file 


The gwpo. dc file is the distribution copy of the data dictionary for creating and rebuilding 
GroupWise 8, 7, 6.x, and 5.x post office databases (wphost . db files). 


If the gwpo . dc file is missing from a domain, you cannot create or rebuild GroupWise 8/7/6.x/5.x post 
offices in that domain. The original gwpo. dc file is located in the domain directory of the GroupWise 8 
DVD or GroupWise 8 downloaded software image. There is also a copy in the po directory. 


Historical Note: WP Office, the predecessor of GroupWise, was originally designed by WordPerfect 
Corporation (WPCorp). Post offices were originally called hosts. Hence, the name wphost . db. Some 
naming conventions were originally preserved for backward compatibility. 


po directory 


The po subdirectory contains the files from which post offices are created. 


ngwguard.dc file 


The ngwguard.dc file is the distribution copy of the data dictionary for building the following 
databases in the post office: 


* ngwguard.db (guardian database) 


dmxxnn01-FF (document management databases) 


Software Distribution Directory 167 


msgnnn. db (message databases) 
userxxx.db (user databases) 
puxxxxx. db (databases for replicated items like shared folders) 


If the ngwguard. de file is missing from a post office, new databases cannot be created in the post 
office, so the post office cannot grow. The original ngwguard. dc file is located in the po directory of 
the GroupWise 8 DVD or GroupWise 8 downloaded software image. 


In Remote mode, the GroupWise client also uses the ngwguard. de file as the data dictionary for its 
local databases. 


10.2.5 client directory 


The client subdirectory contains all files associated with GroupWise Windows client. See “Client” 
in the GroupWise 8 Administration Guide. 


install file 


The install file is the script that GroupWise Linux client users run to install and set up the 
GroupWise client on their Linux workstations. See “Installing and Starting the GroupWise Linux 
Client” in the GroupWise 8 Installation Guide. 


novell-groupwise-gwclient-version.date.i386.rpm 


The novell-groupwise-client.version.date.i386.rpm file is the GroupWise client package that 
is installed by the Installation script. You can install the client package manually if necessary. To see 
what files are installed by the package, see Section 11.2, “Linux Client,” on page 176. 


novell-groupwise-gwcheck-version.date.i386.rpm file 


The novell-groupwise-gwcheck. version. date.i386.rpm file is the GroupWise Check utility 
package. It is not installed by the Installation script but must be installed manually, as described in 
“Using GWCheck on Linux” in “Databases” in the GroupWise 8 Administration Guide. 


10.2.6 ofviews directory 


The client \ofviews subdirectory contains platform-specific subdirectories of view files for use by 
the GroupWise client. On Linux, the win subdirectory contains the view files for the Windows client, 
so that users on a Linux post office can use the Windows client if desired. The Linux client does not 
use view files like the Windows client does. 


In addition, the gwviewxx.ini and ofviewxx. ini files configure custom views on the menus where 
users select views in the Windows client. The gwviewxx. ini file configures GroupWise 8, 7, 6.x, and 
5.5 views. The of viewxx. ini file configures views from earlier versions of GroupWise. 


10.2.7 admin directory 


The admin subdirectory contains subdirectories for administrative tools that can be used with 
GroupWise. 
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novell-groupwise-admin-version.date.i386.rpm file 


The novell-groupwise-admin. version. date.i386.rpm file is the GroupWise administrator 
package that is installed by the Installation script. It contains the GroupWise Administrator snap-ins 
to ConsoleOne. You can install the admin package manually if necessary. 


novell-groupwise-dbcopy-version.date.i386.rpm file 


The novell-groupwise-dbcopy. version. date.i386.rpm file is the GroupWise Database Copy 
utility package. It is not installed by the Installation script but must be installed manually, as 
described in “Using DBCopy on Linux” in “Databases” in the GroupWise 8 Administration Guide. 


novell-groupwise-gwcheck-version.date.i386.rpm file 


The novell-groupwise-gwcheck. version. date.i386.rpm file is the GroupWise Check utility 
package. It is not installed by the Installation script but must be installed manually, as described in 
“Using GWCheck on Linux” in “Databases” in the GroupWise 8 Administration Guide. 


NOVLc1Linuxjre-version.i386.rpm file 


The NOVLc1Linuxjre-version.i386.rpm file is the package that updates ConsoleOne so that it is 
compatible with the GroupWise Administrator snap-ins. It is installed for you automatically when 
you install GroupWise administration. 


monitor directory 


The monitor subdirectory contains the GroupWise Monitor software. See “Monitor” in the 
GroupWise 8 Administration Guide. 


novell-groupwise-gwmon-version.date.i386.rpm file 


The novell-groupwise-gwmon. version. date.i386.rpm file is the GroupWise Monitor Agent 
package that is installed by the Installation script. You can install the package manually if necessary. 
To see what files are installed by the package, see Section 8.4, “Monitor Agent Installation,” on 

page 127 and Section 9, “Web Application Installation Directories on Your Web Server,” on page 133. 


novell-groupwise-monitor-version.date.i386.rpm file 


The novell-groupwise-monitor. version. date.i386.rpm file is the GroupWise Monitor 
Application package that is installed by the Installation script. You can install the package manually 
if necessary. To see what files are installed by the package, see Section 8.4, “Monitor Agent 
Installation,” on page 127 and Section 9, “Web Application Installation Directories on Your Web 
Server,” on page 133. 


grpwise-ma file 


The grpwise-ma file is the Monitor Agent startup script. During installation, it is placed in /etc/ 
init.d. For more information, see “Starting the Linux Monitor Agent as a Daemon” in “Installing 
GroupWise Monitor” in the GroupWise 8 Installation Guide. 
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Snngrpwise-ma file 


The Snngrpwise-ma file is the Monitor Agent startup script that is placed in the rc3.dand rc5.d 
subdirectories of /etc/init.dif you choose to have the Monitor Agent start automatically when the 
server reboots. For more information, see “Starting the Linux Monitor Agent as a Daemon” in 
“Installing GroupWise Monitor” in the GroupWise 8 Installation Guide. 


10.2.8 internet directory 


The internet subdirectory contains subdirectories for GroupWise components that provide and 
support Internet connectivity. 


gwia directory 


The gwia subdirectory contains the Internet Agent software, used to connect GroupWise systems 
across the Internet and to allow GroupWise users to exchange e-mail with users of various Internet e- 
mail programs. See “Internet Agent” in the GroupWise 8 Administration Guide. 


novell-groupwise-gwia-version.date.i386.rpm file 


The novell-groupwise-gwia.version.date.i386.rpm file is the Internet Agent package that is 
installed by the Installation script. You can install the package manually if necessary. To see what files 
are installed by the package, see Section 8.2, “Internet Agent Installation,” on page 110. 


novell-groupwise-gwha.version.date.i386.rpm 


The novell-groupwise-gwha. version. date.i386.rpm file is the GroupWise High Availability 
service package that is installed by the Installation script. It is automatically installed along with the 
Internet Agent. You can install the High Availability package manually if necessary. To see what files 
are installed by the package, see Section 8.2.2, “Linux Installation Directory,” on page 112. 


root directory 


The root directory contains boilerplate versions of the configuration files that are installed to the 
Internet Agent root directory under the domain directory. For more information, see Section 7.5, 
“Internet Agent Queue Directory,” on page 83. 


grpwise file 


The grpwise file is the Internet Agent startup script. During installation, it is placed in /etc/init.d. 
If you choose to have the Internet Agent start automatically when the server reboots, the Installation 
script places symbolic links to it named Snngrpwise in the rc3.d and rc5 .d subdirectories of /etc/ 
init.d. For more information, see “Linux: Starting the Internet Agent” in “Installing the GroupWise 
Internet Agent” in the GroupWise 8 Installation Guide. 


webacces directory 
The internet \webacces subdirectory contains the GroupWise WebAccess software, which allows 


users to access their GroupWise mailboxes from a Web browser. See “WebAccess” in the GroupWise 8 
Administration Guide. 
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10.2.9 


10.2.10 


novell-groupwise-gwinter-version.date.i386.rpm file 


The novell-groupwise-gwinter. version. date.i386.rpm file is the WebAccess Agent package 
that is installed by the Installation script. You can install the package manually if necessary. To see 
what files are installed by the package, see Section 8.3, “WebAccess Agent Installation,” on page 117. 


novell-groupwise-webaccess-version.date.i386.rpm file 


The novell-groupwise-webaccess.version.date.i386.rpm file is the WebAccess Application 
package that is installed by the Installation script. You can install the package manually if necessary. 
To see what files are installed by the package, see Section 8.3, “WebAccess Agent Installation,” on 
page 117 and Section 9, “Web Application Installation Directories on Your Web Server,” on page 133. 


root directory 


The root directory contains boilerplate versions of the configuration files that are installed to the 
WebAccess Agent root directory under the domain directory. For more information, see Section 7.4, 
“WebAccess Agent Queue Directory,” on page 81. 


grpwise file 


The grpwise file is the WebAccess Agent startup script. During installation, it is placed in /etc/ 
init.d. For more information, see “Starting the Linux WebAccess Agent” in “Installing GroupWise 
WebAccess” in the GroupWise 8 Installation Guide. 


Snngrpwise file 


The Snngrpwi se file is the WebAccess Agent startup script that is placed in the rc3.d and rc5.d 
subdirectories of /etc/init .dif you choose to have the WebAccess Agent start automatically when 
the server reboots. During installation, it is named grpwise and placed in /etc/init.d. For more 
information, see “Starting the Linux GroupWise Agents on System Startup” in “Installing 
GroupWise Agents” in the GroupWise 8 Installation Guide. 


webserver directory 


On Linux, you can install Apache and Tomcat along with WebAccess and Monitor. This 
automatically integrates WebAccess and Monitor into Apache and Tomcat for you. If you are already 
running Apache and Tomcat, you can choose to integrate WebAccess and Monitor into that 
installation, or you can have two Apache/Tomcat installations on your server. WebAccess and 
Monitor cannot be used without a supporting Web server. For more information, see “Determining 
the WebAccess and WebPublisher Applications’ Configuration” in “Installing GroupWise 
WebAccess” and “Determining the Monitor Application’s Configuration” in “Installing GroupWise 
Monitor” GroupWise 8 Installation Guide. 


license directory 


The license subdirectory contains the GroupWise Software License Agreement in multiple 
languages. Use the more command to view the License Agreement. 


docs directory 


The docs subdirectory contains the GroupWise pointer Readme. 
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10.2.11  gwinst directory 


The gwinst subdirectory contains supporting files and subdirectories used by the Installation script. 


clusterimport.conf file 


The clusterimport .conf file is created by the GroupWise Installation program when you select 
Configure GroupWise for Clustering. It stores your responses from when you installed a GroupWise 
agent on the preferred cluster node, so that on subsequent nodes, the Import Clustering Data option is 
available. For information about clustering GroupWise, see the GroupWise 8 Interoperability Guide. 
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1 GroupWise Client Installation Directories 


¢ Section 11.1, “Windows Client,” on page 173 


è Section 11.2, “Linux Client,” on page 176 


¢ Section 11.3, “Mac Client,” on page 178 


11.1 Windows Client 


Mc: \Program 
Files\Novell\GroupWise 
_] grpwise.exe 
_] notify.exe 
_] addrbook. exe 
_] gwdca.exe 


_] htrsetup.exe 
_] gwimpexe.exe 
_] gwmailto.exe 
_] gwreload.exe 
_] gwsync.exe 


_] ngwguard.de 
_] wprof .de 


LÌ *.dl1 
_] *.ocx 
LJ} +. ELE 
_] *.chm 
Es] gwcheck 


HH] ofviews 
B win 
_] *.vew 
O *.ini 
el ppforms 
L] *.b£p 
_]*.prs 


Installation directory for GroupWise 8.x Windows client software 


GroupWise client program 
GroupWise Notify program 
GroupWise Address Book program 
Document Converter Agent program 


Hit the Road setup program 
GroupWise E-Mail Importer Utility 
Web browser support program 
Mailbox mode switching program 
Mailbox synchronization program 


Data dictionary for databases 
Data dictionary for Remote Address Book 


DLL programs to support GroupWise Windows client 
OLE custom controls 

Graphics filters for Inso viewers 

Help files to support the GroupWise client 
GroupWise Check utility 


GroupWise view files 

GroupWise view files for Windows 
View files 

View initialization files 


Day planner forms 
Form description files 
Print resource files 


GroupWise Client Installation Directories 


173 


11.1.1 


11.1.2 


11.1.3 


11.1.4 


11.1.5 


11.1.6 


11.1.7 


c:\Program Files\Novell\GroupWise 


The GroupWise Windows client installation directory contains all files necessary to run the 
GroupWise client. The default location is c:\Program Files\Novell\GroupWise. 


¢ Fora standard installation, the GroupWise client directory resides on the user's workstation. 


¢ Fora workstation installation, the GroupWise client directory resides on the network and is run 
by users on many workstations. 


+ Fora remote GroupWise installation, the GroupWise directory contains the same files as would 
be installed on a workstation connected to the network. Whenever GroupWise cannot make a 
network connection, it checks for a Remote mailbox to access. See Section 7.7, “Remote Mailbox 
Directory,” on page 94. 


grpwise.exe file 


The grpwise.exe file is the GroupWise 8 client program for use with Windows. 


gwdca.exe file 


The gwdca. exe file is the Document Conversion Agent, which converts attached documents to 
HTML for indexing. Most indexing is performed by the Document Conversion Agent associated with 
the POA, as described in “Configuring the Document Conversion Agent for Indexing Specific 
Document Types” in “Post Office Agent” in the GroupWise 8 Administration Guide. However, when the 
GroupWise client is not in Online mode, it can perform indexing using the local Document 
Conversion Agent. 


notify.exe file 
The notify.exe file is the program that alerts you whenever you have incoming items, when your 


outgoing items are opened, or when you have an upcoming appointment. Notify can alert you in 
four ways: a sound, a dialog box, a small icon, or by launching an application. 


addrbook.exe file 
The addrbook. exe file is the program that accesses the GroupWise Address Book. The Address Book 


contains information for all Novell eDirectory users, GroupWise external users, GroupWise external 
entities, GroupWise e-mail distribution lists, and so on. 


htrsetup.exe file 


The htrsetup.exe file is the setup program for Hit the Road, which creates your Remote mailbox. 
See “Remote Mode” in “Client” in the GroupWise 8 Administration Guide. 


gwimpexe.exe file 


The gwimpexe . exe file is the GroupWise E-Mail Importer Utility, which enables you to import 
supported POP3/IMAP4 accounts into GroupWise. See “POP3 and IMAP4 Accounts” in the 
GroupWise 8 Windows Client User Guide. 
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11.1.8 


11.1.9 


11.1.10 


11.1.11 


11.1.12 


11.1.13 


11.1.14 


11.1.15 


gwmailto.exe file 
The gwmailto. exe file is the program that integrates the GroupWise client with your Web browser. If 
you select Internet Browser Mail Integration during installation, the GroupWise client becomes the 


default e-mail program on your workstation. See “Installing the GroupWise Clients” in the 
GroupWise 8 Installation Guide. 


gwreload.exe file 
The gwreload. exe file is the program that restarts the GroupWise client when you switch between 


Online, Caching, and Remote modes. See “Using Caching Mode” and “Using Remote Mode” in the 
GroupWise 8 Windows Client User Guide. 


gwsync.exe file 


The gwsync . exe file is the program that synchronizes your Online and Caching mailboxes. See 
“Using Caching Mode” in the GroupWise 8 Windows Client User Guide. 


ngwguard.dc file 


The ngwguard. dc file is the data dictionary for building databases in the post office. In Remote mode, 
the GroupWise client also uses the ngwguard.dc file as the data dictionary for its local databases. 


wprof.dc file 


The wprof . de file is the data dictionary for the remote GroupWise Address Book (wprof . db). 


Historical Note: An earlier version of the GroupWise client Remote mode, designed by WordPerfect 
Corporation (WPCorp), was named WP Office Remote. Hence, the wprof in wprof .dc. Some naming 
conventions were originally preserved for backward compatibility. 


* dll files 


* .d11 files are dynamically linked libraries of program code used by executable programs. 
Language-independent * .d11 files are typically located in the same directory with the executable 
programs they support. Language-specific *.d11 files are grouped into subdirectories by language. 


* ocx files 


* .ocx files are OLE custom controls. For example, * . ocx files control the Address Book and name 
completion. 


* fit files 


* flt files are graphics filters used by the Inso viewers incorporated into the GroupWise client. The 
viewers enable you to view a wide variety of file types from within GroupWise. 
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11.1.16 


11.1.17 


11.1.18 


11.1.19 


11.2 


* chm files 


* .chm files contain the online documentation for all components of GroupWise. * . chm files are 
typically located in the same directory with the executable programs they support. 


gwcheck directory 
The gwcheck directory contains the GroupWise Check utility that can be made available in the 


GroupWise client by clicking Tools > Repair Mailbox. For more information, see “Repairing Your 
Mailbox” in “Maintaining GroupWise” in the GroupWise 8 Windows Client User Guide. 


ofviews directory 


The ofviews directory contains platform-specific subdirectories of view files for use by the 
GroupWise client. 


Historical Note: An earlier version of GroupWise, designed by WordPerfect Corporation (WPCorp), 
was named WP Office. Hence, the of in ofviews. Some naming conventions were originally 
preserved for backward compatibility. 


win directory 


The win subdirectory contains view (* . vew) files for use by the GroupWise client. It also contains 
initialization (* . ini) files to control display of views. 


ppforms directory 


The ppforms directory contains day planner forms for printing GroupWise calendars and tasks. 


*.bfp files 


* .b£p files are form description files that contain binder, filler, and page attributes for forms. 


* prs files 


* .prs files are print resource files that indicate which forms are available for which languages. For 
example, day planners used by English-speaking people in the United States have different forms 
from day planners used for various languages in Europe. 


Linux Client 


dal /opt/novell/groupwise/client GroupWise Linux client installation directory 


_] gwclient .desktop Desktop shortcut for the Linux client 

_] gwclient.png Desktop icon for the Linux client shortcut 

@ bin Subdirectory for the Linux client executable 
_] groupwise Linux client executable 
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11.2.1 


11.2.2 


11.2.3 


E lib Subdirectory for Linux client library files 


_] gwenlxxx.fil Linux client language resource files 

_] ngwguard. dc Data dictionary for local databases on the user's workstation 

_] wprof .de Data dictionary for the local copy of the Address Book 

LJ +. Ele Java archive (.jar) files used by the Linux client 

L]*.jar Shared library files used by the Linux client 

LÌ *.so 
el java Java Runtime Environment (JRE) used by the Linux client 
E logs Log files generated by the Linux client 


lopt/novelllgroupwise/client directory 


The /opt/novel1/groupwise/client directory is the default location for the GroupWise Linux 
client software. The Installation program does not provide the opportunity to specify a different 
location and typically there is no need to move the software. 


gwclient.desktop file 


The gwclient .desktop file create the GroupWise Linux client shortcut on your Linux desktop. 


gwclient.png file 


The gwclient . png file is the GroupWise icon used for Linux client shortcut. 


bin directory 


The bin directory is the standard Linux location for executable files. 


groupwise file 


The groupwise file is the GroupWise Linux client executable. See “Installing and Starting the 
GroupWise Linux Client” in the GroupWise 8 Mac/Linux Client User Guide. 


lib directory 


The 1ib directory is the standard Linux location for library files. 


gwenlxxx.fil file 


The gwen1xxx.file provides the language-specific strings for the localized versions of the Linux client. 


The xx is a two-letter language code. 


ngwguard.dc file 


The ngwguard. dc file is the data dictionary for building the databases used by the Linux client. It is 


parallel in function to the ngwguard. dc file in the post office. 
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wprof.dc file 


The wprof . dc file is the data dictionary used to create the local copy of the Address Book that resides 
on the user's workstation (wprof . db). 


* jar files 


The * . jar files efficiently store information referenced by the Linux client. The gwclient .jar file 
contains the Linux online help information. 


* so files 


The * . so files are Linux shared library files the provide information to the Linux client executable. 


11.2.4 java directory 


The jre directory holds the version of the Java Runtime Environment (JRE) that is required by the 
Linux client. 


11.2.5 logs directory 


The logs directory stores log files generated by the Linux client when an error occurs. 
11.3 Mac Client 


E /Applications/GroupWise GroupWise Mac client installation directory 


HH] Contents Standard Macintosh directory for application files 
_] PkgInfo Standard Macintosh package info file 
_] Info.plist Standard Macintosh package list file 
E macos Standard Macintosh directory for operating system files 
E Resources Standard Macintosh directory for resource files 
_] GroupWise.icns Icons used by the Mac client 
MN) lib Subdirectory for Mac client library files 
_] gwenlxxx.fil Data dictionary for local databases on the user's workstation 
L] ngwguard.dc Data dictionary for the local copy of the Address Book 
L] wprof .de Mac client language information files 
_]*.jar Java archive (.jar) files used by the Mac client 
Li *.dylib Dynamic libraries used by the Mac client 


11.3.1 /Applications/GroupWise.app directory 


The /Applications/GroupWise.app directory contains the GroupWise Mac client. 
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11.3.2 


11.3.3 


11.3.4 


11.3.5 


Contents directory 


The Contents directory is the standard location on Macintosh for all files that make up an 
application. 


MacOS directory 


The MacOS directory contains the JavaApplicationStub file that enables the Mac client to invoke the 
Java Virtual Machine (JVM). 


Resources directory 


The Resources directory is the standard location on Macintosh for files that support an application. 


GroupWise.icns file 


The GroupWise.icns file contains all the images that display in the Mac client. 


lib directory 


The lib directory holds library files that provide information required by the Mac client. 


gwenlxxx.fil file 


The gwen1xxx.file provides the language-specific strings for the localized versions of the Mac client. 
The xx is a two-letter language code. 


ngwguard.dc file 


The ngwguard. dc file is the data dictionary for building the databases used by the Mac client. It is 
parallel in function to the ngwguard. dc file in the post office. 


wprof.dc file 


The wprof . dc file is the data dictionary used to create the local copy of the Address Book that resides 
on the user’s workstation (wprof . db). 


* jar files 


The * . jar files efficiently store information referenced by the Mac client. The gwclient jar file 
contains the Mac online help information. 


* dylib files 


The * .dylib files are dynamic library files the provide information to the Mac client program. 
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Documentation Updates 


This section lists updates to Troubleshooting 3: Message Flow and Directory Structure that have been 
made since the initial release of GroupWise 8. The information helps you to keep current on 
documentation updates and, in some cases, software updates (such as a Support Pack release). 


The information is grouped according to the date when Troubleshooting 3: Message Flow and Directory 
Structure was republished. Within each dated section, the updates are listed by the names of the main 
table of contents sections. 


Troubleshooting 3: Message Flow and Directory Structure has been updated on the following dates: 


+ Appendix A, “June 26, 2012 (GroupWise 8 SP3),” on page 183 
+ Appendix B, “August 31, 2009 (GroupWise 8 SP1),” on page 185 
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June 26, 2012 (GroupWise 8 SP3) 


Location Change 


Directory Structure 
Diagrams 


Chapter 9, “Web Application Updated the Linux Web server directory structures for Tomcat 6. 
Installation Directories on 

Your Web Server,” on 

page 133 


June 26, 2012 (GroupWise 8 SP3) 183 
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August 31, 


Location 


Directory Structure 
Diagrams 


Section 7.2, “Post Office 
Directory,” on page 64 


Section 7.3, “MTA Local 
Queue Directory,” on 
page 77 


Section 7.6, “Caching 
Mailbox Directory,” on 
page 89 


Section 8.3.4, “Document 
Viewer Agent Working 
Directory,” on page 126 


Section 9, “Web Application 
Installation Directories on 
Your Web Server,” on 

page 133 


Section 10.2, “Linux 
Software Distribution 
Directory,” on page 163 


Section 11.3, “Mac Client,” 
on page 178 


2009 (GroupWise 8 SP1) 


Change 


Clarified the difference in functionality in the wocsin priority 
subdirectories when using mapped/UNC links vs. TCP/IP links, added the 
gwdca subdirectory. 


Noted that the location for MTA log files is different on Linux. 
Added default Caching mailbox directories on Windows Vista, Linux, and 
Mac. 


Added the gwdvannn. ste files. 


Updated the Web server installation directories. 


Added the clusterimport . conf file. 


Updated the Mac client installation directory. 
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